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I. INTRODUCTION 

A. General Description 

SLEUTH (Symbolic LanguagE for the UNIVAC® 1 i 07 THln 
Film Computer) is an advanced symbolic Assembly System 
which provides the programmer "with a powerful and effi- 
cient tool for writing programs for the 1107 Computer. 
It accepts instructions containing mnemonic function 
codes and designators, and symbolic operand addresses, 
and translates these instructions to an absolute or re- 
lative form ready for loading and execution. 

SLEUTH is a two pass assembly system. The first pass 
is devoted to- merging corrections with the source code 
input, developing a dictionary of symbolic assignments, 
and doing a major portion of decoding each symbolic in- 
struction. The second pass uses the output of the first 
pass and the dictionary to complete every instruction. 
It produces the desired binary output, a listing, and a 
corrected source code if requested. 

A set of declarative functions is provided to instruct 
the Assembler in the special details of assembly which 
include* 

Definition and generation of macros 

Insertion of Library Routines from a Library Tape 

Equation of symbols 

Protection against duplication of symbols 

Corrections to the source code 

Deletion of any predetermined set of instructions 
which is primarily designed for, but not limited 
to, deletion of debugging aids at the completion 
of code checking. 

B. Program Types 

Three types of binary output can be produced by the As- 
sembler, of which two are in relocatable binary form, 
or Relative Object Code (ROC). Absolute output (AOC) 
can also be obtained for a completely defined program. 

Programs which perform input/output operations internal- 
ly, and which are to be run serially, may be in the 
Direct I/O form of ROC (DIRECT ROC). Relocation or re- 
assignment of addresses, and modification of peripheral 
facilities is possible at load time. 
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Another form of ROC output is produced for concurrent 
processing under the control of the Executive System, 
using the latter f s I/O Functional Routines for all 
input/output operations, and allowing the Executive 
System to make all assignments of memory and I/O units. 
This form is called EXEC ROC. 

Figure 1 is a system chart illustrating the various 
types of SLEUTH output and the manner in -which the as- 
sembled programs are loaded and run. 

C. Program Structure 

A program may consist of one or more segments. Each 
segment of a program consists normally of an instruction 
area, and a data area, In opposite banks of core stor- 
age. 

Data tables, primarily defined for ROC type programs, 
are included in the data area. A data table is a group 
of data words which may be considered by the program as 
an entity. Each entry within a data table bears a fixed 
relationship to the first entry and may be referenced 
via this first, entry. Each data table is Independent of 
any other except when specified to begin at the same lo- 
cation as another. The data tables, although they may 
be included within any one segment, are common to all 
segments of a program and may be referenced by any seg- 
ment . 

For ROC type programs each data table is modifiable in 
length at load time. A length tag is given to the table. 
and a minimum length is assigned during assembly. At 
load time a new length can be specified, depending on 
the particular data to be operated upon during the run. 

Figure 2 illustrates the most complex form of program. 
Note that data table number k has been specified to be- 
gin at the same location as data table number 2. 
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II. ASSEMBLY LANGUAGE FORMAT AND SYMBOLOGY 

A. Coding Form 

Programs to "be written with the SLEUTH Assembly System 
will be coded on the UNIVAC 1107 Assembler Coding Form. 
Figure 3 is a reproduction of this form. 

The form is divided into h major headings: Tag, Function, 
Sub-fields, and Comments. 

1. Tag field: The Tag field can be blank, or coded with 
a Tag or Label. The coded Tag will be defined by the 
instruction, and should therefore appear once, and 
once only, in the Tag field. A method of protecting 
against accidental duplication of tags is described 
in Section VIII. 

A Tag or Label can be written anywhere In the Tag 
field; right or left justification is not required. 
Blank spaces are ignored by the Assembler; the follow- 
ing coding of Tags will generate the same value: 

XYZAAA 
AXYZAA 
AXAYAZ 

2 Function field: The Function field will contain one 
of the Function codes described in Section III. 

3. Sub-fields: The Sub-fields represent the data neces- 
sary to describe the objective of the Function code: 
what Is to be acted upon and how. 

Each of the sub-fields must be separated by a comma, 
except where specified otherwise in context. For 
each Function, the order of fields is fixed. How- 
ever, for many Functions, the use of certain sub- 
fields may be unnecessary or optional. For example, 
Indexing may or may not be desired. The following 
rules must be observed when omitting fields from 
the coding: 

a. To omit any field(s) from the right, the field(s) 
and the preceding comma(s) should be omitted. 

b. To omit other fields, while preserving the order, 
only the separating commas are coded. 
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Co For a sub-field within an instruction which re- 
quires that it he coded, any number of + or - 
signs may be coded in the field to inform the 
Assembler tHgt the omission of meaningful coding 
is intentional. The field will then be gener- 
ated as zeros, without causing SLEUTH to print 
an error indication, 

*t. Comments: Any line of coding may have a short des- 
criptive comment associated with it. Any of the 
FIELDATA characters can be used.- The Comments can 
start at any point after the colon. A line of 
coding can consist of a Comment only, to separate 
and identify portions of the program. A blank line, 
for spacing, is a valid use of this application. 

B. Number and Symbol Representation 

Numbers and symbols are represented in SLEUTH source 
code as combinations of the characters of the standard 
FIELDATA set shown in Appendix A. 

1 . Numbers 

Numbers may be coded in decimal or octal notation. 
Either form may be written whenever an integer value 
is to be coded. SLEUTH will not accept direct coding 
of binary numbers. 

Decimal integers are coded with any combination of 
the decimal digits to 9» 

Octal integers are coded with any combination of the 
octal digits to 7j and are identified as octal by 
prefixing them with a dollar sign. 

Rational decimal numbers, written with either an ac- 
tual or implied decimal point, are used in the gene- 
ration of floating point, and of fixed point scaled 
whole numbers. 

Examples of numerical coding are given below, as 
they might appear in the sub-fields portion of a cod' 
ing line: 

"1357986 Positive decimal integer 

+1357986 Positive decimal integer 

-$2h6753 Negative octal integer 

-99 ,$32 Mixed half words 

9986. 2^3 5 2 Floating point number 

998,-2,7 Fixed point scaled number 
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A negative number must be preceded by a - sign. A 
positive number may be preceded by a + sign, or left 
unsigned. When a sign is specified, the magnitude of 
the generated field is checked by SLEUTH to insure 
that a position is available for the sign bit. If 
no sign is specified, no check is made. This becomes 
especially important in the generation of fractional 
words, which will be discussed in detail in Section 
IV o See Figure h. 



CODED 


GENERATED 


CHECKED 


RESULT 


31 or $37 


011 111 


No 


OK 


+31 or +$37 


011 111 


Yes 


OK 


32 or $^+0 


100 000 


No 


OK 


+32 or +$^0 


100 000 


Yes 


Error 



FIGURE k 



2. Symbols 



A symbol is some combination of from one to six al- 
phabetic (A to Z) and numerical (0 to 9) characters. 
Each symbol must contain at least one alphabetic 
character . 

Some symbols are Internally defined by SLEUTH, or 
by other System components, e.g., Designators, -while 
others are the Inventions of the programmer, e.g., 
Tags and Labels. Symbols defined by SLEUTH are pre- 
fixed with a dollar sign, and a list of these given 
in Appendix E. 

Symbols can appear in the Tag, Function, or Sub- 
fields areas of the coding line. Examples of various 
symbols are given below: 



C0NST2 
C0NST3 
DATA2A 

123^K 

N5 
EXIT 

K 
ADD 
EQU 



Programmer defined symbol 
it 



5L 



Mnemonic Function Code 
Assembler defined Function code 
" " Designator 
" " Current address Taj 
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III. COMPONENTS OF A LINE OF CODING 

A. General Description 

A line of coding is a complete source language statement. 
It may be an Instruction, a data definition, a communica- 
tion with the Assembler, with the Executive System, etc.. 
There must be an entry in the Function field for each 
line of coding, except where the line consists solely of 
comments; entries In any of the other fields may or may 
not be required. 

The instruction portion of the line of coding is termi- 
nated by a colon (:), which may be coded at any point 
after the last coded field. Even where no sub-fields are 
required, the colon must still be coded. 

Following the colon, a comment explaining the line of 
coding may be written. Any FIELDATA characters which can 
be printed are acceptable, including a blank space (coded 
as A or uncoded), and the colon. The latter, having pre- 
viously served its purpose as an instruction terminator, 
becomes just another character in the comments field. 

A line of coding is not limited in length to a single 
line of the coding form, but may be extended by Indenting 
the next, and subsequent, lines by at least 15 spaces. 

Any line may be prefixed by an asterisk (*). Such lines 
can be optionally either included in the assembly, or 
eliminated as explained in Section VII. 

The fields and sub-fields which comprise a line of coding 
are made up of various components, which can be classi- 
fied as: 

Actual Values 
Special Characters 
Function Codes 
Tags and Labels 
Designators 

B. Actual Values 

An actual value is a true, signed, numerical quantity, 
and can be coded as a decimal or octal integer, a float- 
ing point decimal, or a fixed point scaled number. 

C. Special Characters 

FIELDATA characters other than letters and numbers are 
called Special Characters. They can be punctuation 
marks, mathematical symbols, symbolic abbreviations, 
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or non-printing Typewriter Operations. A list of these 
characters is given below, with a brief note about their 
use in coding. A more detailed explanation for each 
will be given in context. Special characters not shown 
here serve no special purpose in programming but may be 
used as part of the comments. 

1. Punctuation marks: 

Colon : Instruction Termination 

Comma , Separator 

Ditto mar.k " Function code repetition 

Parentheses ( ) Separator 

Slash / Separator 

Asterisk * Instruction Deletion or h- and 

i-field incrementation 

2. Mathematical Symbols: 

Plus + Positive sign or Tag modification 

Minus - Negative sign or Tag modification 
Equals = Equality 

3. Symbolic Abbreviations: 

Blank A Blank Space 

Dollar Sign $ Octal number and Designator 

Identifier 

k. Typewriter Operations: 

(Octal Codes) 



00 


Master Space 


01 


Upper Case 


02 


Lower Case 


03 


Tab 


0>+ 


Carriage Return 


05 


Space 


77 


Backspace 



D. Function Codes 

The Function code is the primary operator of each line 
of coding, and must invariably be present in each line, 
except as previously noted. 
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A ditto mark (") coded In the Function code field can be 
used to eliminate repetitive coding of the same instruc- 
tion. See Figure 5 • 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS / 


1 1 1 1 1 1 




iS.T.S, , 




,SUM ' ) 


1 1 1 1 1 1 


i l"l I I 


.SUM + 1 : ( 


1 1 1 1 1 1 


i i ' i i i 


,SUM+2 : ) 


1 1 1 1 1 1 


i 1 I 1 l 


J 






S — r 



FIGURE 5 



There are three types of Function codes discussed in this 
manual: 

1. Hardware: These are mnemonic, symbolic equivalents 
of the machine functions. They may also be coded as 
octal integers, if desired. A complete list of these 
codes will be found in Appendix B. 

2. Software: These are Assembler defined operations, 
some of which will generate words in the object pro- 
gram, while others provide instructions to the As- 
sembler. A complete list of these codes will be 
found in Appendix C. 

3. Macro-instructions and Subroutine Generatives: These 
are either system or programmer defined macro-instruc- 
tions, or subroutine-generative instructions, and will 
be discussed in Sections VI and XIV. 

E. Tags and Labels 

A Tag is a symbol, not to exceed 6 characters which is 
defined by the programmer, the Assembler, or other sys- 
tem components. The use of Tags is not restricted to 
the Tag field; they can also appear in any of the vari- 
able sub-fields. 

Each Tag symbol should be unique. However, since it is 
possible that duplication of symbols may inadvertently 
occur - for instance, In a problem which is being writ- 
ten by two or more programmers - a procedure is provided 
to prevent such accidental duplication from destroying 
the assembly. This procedure will be discussed in Sec- 
tion VIII . 



SLEUTH 11 



Tags are classified by SLEUTH by the method employed in 
defining them, and special names are used to describe 
each type of Tag. 

Absolute Tag 

Label 

Data Table Tag 

Data Table Length Tag 

Drum Table Tag 

Drum Table Length Tag 

Segment Length Tag 

System Tag 

I/O Channel Tag 

I/O Access Word Tag 

I/O Unit Tag 



1 c Absolute Tag 

An Absolute Tag 
tual value. It 
solute Tag. Be 
can be made, it 
Each value is a 
value of 2 23 -1 . 
an Absolute Tag 
50000. TOPS is 
to the previous 



is a symbol which represents an ac- 
can also be equated to another Ab- 

fore any reference to an Absolute Tag 
must have been previously defined, 
signed quantity, with a maximum 

In the example in Figure 6, MAXM is 
which the instruction equates to 
also an Absolute Tag which is equated 

ly defined Absolute Tag MAXM. 



TAG 



9 FUNCTION 14 



15 



SUB FIELDS 



|M| A|X |M| 



|T|Q|P|S| 



EiQ,U 



sgrorofof 



E,Q,U 



MAXM 




2. Label 



FIGURE 6 



A Tag appearing as the symbolic address of a word in 
the Instruction or Data area of storage is called a 
Label. It always represents a 16-bit positive value 
which is the absolute or relative location of the as- 
sociated word. 
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A line of coding can be referenced by modifying a 
Label in the form: Label ± Increment. 1 The incre- 
ment is a numerical value derived from the algebraic 
sum of a combination of integers and Absolute Tags. 
The seQuence in which this combination is coded is 
not significant. The resulting sum of the basic 
label and the increment must be a positive value, 
although the increment itself may be negative, 
positive or zero. Examples of Labels, incremented 
and non-incremented, are: 



START 
STEP A+8 
DATA-MODFR 
DATA-1 0+MODFR 
DATA+MODFR-10 



no increment 

± integer 

± Absolute Tag 

± integer and Absolute Taj 

Same in reverse order 



A line o 
sembler- 
value of 
the curr 
dress ca 
as descr 
the cont 
the next 
the curr 



by using the As- 

to represent the current 

counter, i.e., the address of 



f coding can be referenced 
defined Label "$L " 

the location 
ent instruction. Modification of this ad- 
n be effected in the form: $L + Increment, 
ibed above. In the example in Figure 7, if 
ents of arithmetic register A2 are zero, 



instruction will 
ent instruction** 



b( 



two lines below 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS ( 


1 1 1 1 1 1 




,*,R,J,P, 




$A2,$L+2 : ( 


1 1 I 1 1 1 


i i i i i 


( 




- • ^-i-'U- 


_ / 



FIGURE 7 



3. Data Table Tag -Data Table Length Tag 

A Data Table Tag is a Label which represents the 
first address of a table named by the Tag. The 
Data Table Tag is defined by the declarative Func- 
tion code DTABLE, and can be equated to another Data 
Table Tag. Associated with the Data Table Tag is 



■The character ± is used to indicate that either a + sign or a 
- sign may be used in the coding, but the combination ± can 
never be coded. 
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the Data Table Length Tag, which represents the num- 
ber of storage locations required to contain the 
table. The length is defined by equating the Tag to 
an actual value or Absolute Tag. 

The uses of these Tags -will be explained more fully 
in the discussion of the DTABLE instruction in Sec- 
tion V . 

4. Drum Table Tags - Drum Table Length Tags 

These Tags are similar to the Data Table and Data 
Table Length Tags, except for the fact that the 
storage medium is the magnetic drum rather than core. 
A further explanation "will be found in the discussion 
on the MDT instruction in Section V. 

5. Segment Length Tag 

The IBANK and DBAM instructions (see Section V ) 
provide for the coding and definition of Segment 
Length Tags. The Assembler counts the number of 
generated "words in each segment, and assigns that 
value to the Segment Length Tag. The programmer 
xTiust never assign a value to a Segment Length Tag. It 
Is coded "with the same form as a Label. 

6. System Tag 

A set of System Tags, defined jointly by SLEUTH and 
the Executive System, is used in communications be- 
tween the object program and the Executive System. 



System Tags must never be defined by a program. Ab- 
solute output programs, running independently of the 
ROC Load and Executive Systems, must never use Sys- 
tem Tags. 

7. Input/Output (l/0)Channel Tags 

A symbol of 5 characters or less can be assigned 
as an I/O Channel Tag. It provides a 4 -bit value 
for an a-field channel designation in AOC or DIRECT 
ROC type programs. Channel Tags are not required 
for EXEC ROC type programs, but may be used If it 
is desired to refer to the channel. 

Further information on the uses of Channel Tags 
will be found in the discussion of Input/Output, 
Section XII . 
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I/O 
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inp 
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f n 



8. I/O Access Word Tag 

Access Word Tag is the symbolic address of 
ut , or output, access control "word correspond - 
the I/O Channel Ta^ » It is used for Absolute 
and ROC Direct programs only. 

The I/O Access Word Tag is defined internally by 
SLEUTH, and no programmed definition Is required. 
For each Channel Tag, SLEUTH provides an Input Access 
Word Tag and an Output Access Word Tag, identified 
symbolically by an I or prefix to the Channel Tag. 
Modification of Access Word Tags is not acceptable. 

Further information on the uses of Access Word Tags 
will be found in the discussion of Input/Output rou- 
tines, Section XII. 

9. I/O Unit Tag 

The I/O Unit Tag is a symbol representing an I/O 
Unit. Further information on the uses of Unit Tags 
will be found in the discussion of Input/Output rou- 
tines, Section XII. 

F. Designators 

A Designator is an Assembler defined Tag, and is the 
symbolic address of a special register, or a special in- 
dicator value. There are two types: a-type Designators, 
and j-type Designators. 

1 . a-type Designators 

An a-type Designator is defined as the symbolic ad- 
dress of one of the special registers of the thin- 
film memory. It can be coded in the a or b sub- 
fields of an instruction, and will generate a ^-bit 
value in the corresponding field of the machine word. 
It can also be coded in the u-field, and In this 
case will generate a 16-bit octal address. 

The programmer may equate a Tag to an a-type De- 
signator. The coded Tag would represent the Desig- 
nator throughout the program. A single change in 
the definition of the Tag would have the effect of 
changing each reference to the special register. 

A table of a-type Designators is given in Figure 8. 
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DESIGNATOR 


VALUE 


REFERENCE 


Decimal 


Decimal 


Octal 




$B0 








Unassigned 2 


$B1 -$B1 5 


1-15 


1-17 


B Registers 


$A0-$A1 5 


12-27 


1^-33 


A Registers 


$Q0-$Q3 


12-15 


1*4-17 


Q Registers 3 


$R0 


6^+ 


100 


Real Time Clock 


$R1 


65 


101 


Repeat Counter 


$R2 


66 


102 


M Register 


$R3 


67 


103 


T Register 


$R^+-$R1 5 


68-79 


10^-117 


R Registers 



FIGURE 8 



2. j-type Designators 

A j-type Designator is a symbol representing the ap- 
propriate value of the j -field of an instruction. It 
should be used only as the representation of the j- 
field value, and never as a tag representing some 
other field. A ^-bit value is always generated. 

A table of j-type Designators is given in Figure 9» 



DESIGNATOR 


VALUE 


REFERENCE 


Decimal 


Decimal 


Octal 




$W 








Whole word 


$H1-$H2 


2-1 


2-1 


Half words 


$XH1 -$XH2 


k-3 


k-3 


Half words with sign extension 


$T1 -$T3 


7-5 


7-5 


Third words 


$S1 -$S6 


13-8 


15-10 


Sixth words 


$U0P 


Hf 


16 


U -fie Id is actual operand 


txuop 


15 


17 


Same, with sign extension 



FIGURE 9 



'Becomes one of the B Registers with BTR. LBM, TMO instructions. 
It Is always a legitimate designator for location of film me- 
mory. 

The Q Registers are the h overlapping A and B Registers. 
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IV. MACHINE AND GENERATIVE INSTRUCTIONS 

A. Machine Instructions 

The general coding format for a machine instruction word 
is shown in Figure 10. The use of each of the fields 
will be explained below. 



TAG 



9 FUNCTION 14 



15 



SUB FIELDS 



J_L 



I I I I I 



i i i 



o.v, b, t * 



-LUU-UHi 



1 . Tag (t) 

The Tag, if coded, Is a Label, and is the symbolic 
address of the line of coding. 

2. Function code (f ) 

The function code is any appropriate function code 
of the machine instruction repertoire, Appendix B. 
One Assembler-defined Function - JUMP- can also be 
considered as a machine instruction. It is equiva- 



lent to a 
of zero. 



CSJP instruction, with an a-field value 



3. Special Registers (a) 

The a-field normally represents the film memory 
special register involved in a machine operation. 
It can be coded with a decimal or octal integer, an 
Absolute Tag , or most frequently with an a -type De- 
signator. The reference can be to any of the A, B, 
Q, or R registers as determined by the Function code. 

If a Designator is coded which is not of the set 
called for by the Function code - for example, a LDB 
instruction to be performed in register A1 - the Assem- 
bler will attempt to generate a valid a-field value, 
which may or may not be the value intended by the 
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programmer. If a valid value cannot be generated, 
an error "warning will be printed. 

In the examples in Figure 11, the comments refer to 
the a -fie Id coding. 



9 FUNCTION 14 



SUB FIELDS 



37 



COMMENTS 



J ,U,M,P 



_|L 



,EXIT 



g,EX!T 



$A3, LOCA 



$B2, CONST 



$R15,9 9, ,$UOP 



$Q2,ITEM 



COUNT, TOTAL 



13. DATE 



$15, DATA 



$A1,DATA+5 



$B12,CONSTB 



$Q2,XYZ 



$Q2,WXYZ 



$B3,ABC 



UNCODED 



ZERO CODING (SAME AS JUMP) 



DESIGNATOR FOR A-REGISTER 



DESIGNATOR FOR B-REGISTER 



DESIGNATOR FOR R-REGISTER 



DESIGNATOR FOR Q-REGISTER 



ABSOLUTE TAG 



DECIMAL INTEGER = Al 



OCTAL INTEGER = Al 



Al =13 = B13. GENERATED AS 13 



B12 = 12 = A0. GENERATED AS (T 



Q2 = 14=B14. GENERATED AS 14 



Q2= 14 =A2. GENERATED AS 2 



B3 =3 = A?. ERROR WARNING 



FIGURE 11 



k. Operand field (u) 

The u-field serves a variety of purposes and the 
method of coding is dependent upon the application: 

Operand address 

Absolute operand 

Next instruction 

Shift count 

Memory lockout indicator 

Indirect addressing 
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a. Operand Address 

In this application the coding in the u-field 
represents the address at "which the data to be 
operated on will be found. It can be coded as 
a Label, to represent a core address, or as an 
a-type Designator, to represent a film memory 
address. Either type of coding can be modified 
as described in Section III, paragraph E.2.. 
For Absolute or ROC Direct output programs, an 
octal or decimal integer may be coded. A 16- 
bit value is generated in all operand address 
applications . 

b. Absolute Operand 

When the j -fie Id Is an octal 16 or 1 7 5 i.e., 
coded with Designator $U0P or $XU0P, the value 
entered in the u-field becomes the actual oper- 
and, and not the address of the operand. It is 
coded as an octal or decimal integer, or a pre- 
viously defined Absolute Tag. An 18-bit value 
is generated. 

Another method of generating an actual value in 
the u-field is by coding a literal expression. 
This method can be used when the desired value 
is a floating point, or fixed point scaled num- 
ber, or an integer value requiring more than 18 
binary places. An Absolute Tag may also be used. 

A literal expression consists of two parts: the 
appropriate numerical generative Function code 
(see paragraph C), and the required value, 
separated by a comma. The entire expression is 
enclosed within parentheses. 

Words are generated for each literal expression, 
and are added to the end of the DBANK area being 
generated, without duplication. 

c. Next Instruction 

In jump type instructions, the u-field represents 
the core memory address which contains the next 
instruction. Coding is the same as for an oper- 
and address. 
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d. Shift Count 

In all shifting instructions except Scale Factor 
Shift (SFSH), the u-field represents the number 
of binary places to be shifted. This shift count 
should not exceed 72 places, and is coded as a 
decimal or octal integer, or an Absolute Tag. 

e. Memory Lockout Indicator 

A knowledge of the manner in -which this instruc- 
tion operates is essential to an understanding 
of the following explanation. A review of 
chapter 12 of the UNIVAC 1107 Technical Bulletin 
UT 2k63> 5 Central Computer, is recommended. 

The u-field of this instruction requires four 
groups of ^-bit .numbers. Write out the four 
groups in binary, then convert to an octal for- 
mat. For example, If the desired values are 3 ? 
0, 13? and 9> write in binary: 

0011 0000 1101 1001 

The conversion to an octal format -will give the 
coding $3033^ , which is the absolute value to be 
coded in the u-field. An Absolute Tag can also 
be coded. 




FIGURE 12 
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f. Indirect Addressing 

Indirect addressing (setting the i-field to 1 ) 
is effected by coding an asterisk either before 
or after any element of the entry in the u-field 

g. Examples of the above applications are given in 
Figure 12: 

5. Index Registers (b ) 

The b-field specifies one of the B-Registers used 
for indexing purposes. It is coded "with a decimal 
or octal integer, an Absolute Tag, or an a-type De- 
signator. Only $A0-$A3, $Q0-$Q3, and $B1 -$B1 5 are 
valid Designators. 

B-Register incrementation (setting the h-field to 1 ) 
Is effected by coding an asterisk before or after 
the entry In the b-field. 

Examples of b-field coding are given in Figure 13 '• 




SUB FIELDS 



37 



COMMENTS 



$A2,iTEM, $ B 1 0T 



$A2,ITEM,$12 



$A2,ITEM,IDXA 



$A3, OUTPUT ,*$B5 



$A3,OUT PUT,$B5' 



FIGURE 13 



A-TYPE DESIGNATOR 



OCTAL ABSOLUTE ADDRESS 



ABSOLUTE TAG 



B-REGISTER INCREMENTATION 



6. Operand Interpretation (j) 

The j-field is coded with a decimal or octal integer, 
an Absolute Tag, or a j-type Designator. No coding 
Is required where the j-field Is the minor Function 
code, i.e., where the Function is a ^-letter mnemonic 
code. In this case SLEUTH automatically assigns the 
correct value. 

Examples of j-field coding are given in Figure 1^+: 
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FIGURE 1*f 
B. Generative Instructions 

In general, generative instructions are defined as those 
Instructions -which generate one or more -word's in the ob- 
ject program. The folio-wing types of instructions are 
classified as generatives: 

Numerical -word generatives 
Character code generative 
Block reservation generative 
Macro-instruction generatives 
Library Subroutine generatives 
Input/Output instructions 

Macro-instructions, Library Subroutines, and Input/Output 
-will be discussed In separate Sections. 

1 . Numerical Word Generatives 

SLEUTH provides a set of software function codes 
-which are used to define and generate whole or par- 
tial numerical words. The coding line consists of 
a Tag (optional), Function code, and a varying num- 
ber of sub-fields as determined by the Function 
code . 

a. Whole Word Generation 

(1 ) The Function code W will generate a 36-bit 
signed numerical word. The single sub- 
field can be coded with a decimal or octal 
integer, an Absolute Tag, or any symbolic 
coding which represents a numerical value. 
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(2) The Function code WF will generate a Float- 
ing Point number. Two independently signed 
sub-fields are required: a rational decimal 
value, followed by a decimal exponent, se- 
parated by a comma. If the exponent is -zero, 
it can be omitted, and only the value need 
be coded. 

(3 ) The Function code WX will generate a Fixed 
Point Scaled number. Three independently 
signed sub-fields are required: value, de- 
cimal exponent, and binary scale factor. 
The coding of all three fields should be de- 
cimal. In the examples of the WX instruc- 
tion in figure 1 5 5 the same value will be 
generated for all three forms. The exponent 
and/or the scale factor may be omitted if 
they are zero values. 

b. Partial Word Generation 

(1 ) The Function code H will generate two 18-bit 
values into a single word. Each half-word 
is generated, and can be signed, independent- 
ly, and can be coded as a decimal or octal 
integer, an Absolute Tag, an a-type Desig- 
nator, or any symbolic coding which repre- 
sents a numerical value. The value of each 
generated half-word must not exceed 18 
binary bits . 

(2) The Function code T will generate three 12- 
bit values into a single word. Each third- 
word is generated, and can be signed, in- 
dependently, and can be coded as a decimal 
or octal integer, an Absolute Tag, or an 
a-type Designator. The value of each gener- 
ated third-word must not exceed 12 binary 
bits . 

(3) The Function code S will generate six 6-bit 
values into a single word. Each sixth-word is 
generated, and can be signed, independently, 
and can be coded as a decimal or octal in- 
teger, an Absolute Tag, or an a-type Designa- 
tor. The value of each generated sixth-word 
must not exceed 6 binary bits. 
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(h) The Variable Bit Field Function code G will 

generate a number of fields of varying lengths 
into a single word. Each variable field con- 
sists of two parts: the value to be gener- 
ated, and the size of the field in binary 
bits. The two parts are separated by a slash, 
and commas separate one field from another. 

The desired value of each field is coded as a 
decimal or octal integer, an Absolute Tag, an 
a-type Designator, or any symbolic coding 
which represents a numerical value. 

A total of 36 binary places must be accounted 
for, therefore a zero field of the required 
size must be coded at some position of the 
word, if necessary. 

Examples of numerical word generation are 
given in Figure 1J. 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 37 COMMENTS / 


LI Ml T 




I i W , i i 




14400 : POSITIVE DECIMAL INTEGER { 


1C1O1N1S1T1 


i i W, | | 


-$1357 : NEGATIVE OCTAL INTEGER / 


,D,A,T,A, , 


, ,w, , , 


ABC : ABSOLUTE TAG / 


,D|R|M|D|A|T 


w 


DRMADD : DRUM ADDRESS } 


I FiPrNiOi Ai 


! |W,F| i 


6.28,-6 : FLOATING POINT NUMBER / 


1F1P1N1O1B1 


i 1W1F1 i 


_29.33 : NEGATIVE VALUE, EXPONENT ( 


i FiXiPi SiCiA 


i 1W1X1 i 


9.9 8, ,7 : FIXED POINT SCALED NUMBER I 


iFlXlPlSlClB 


l 1W1X1 I 


998.-2.7 :SAMEYALUE ) 


i FiXiPi SiCiC 


l 1W1X1 i 


.998.1.7 : SAME VALUE { 


II IDIXIWIDI 


l iHi i i 


1.0 : DECIMAL HALF-WORDS { 


iW,OiR|D|Ai 


H 


149 82. -$7435 : DECIMAL AND OCTAL HALF-WORDS \ 


,W,0,R,D|B , 


H 


ABSTAG-5, + 25 : MODIFIED ABS. TAG AND DECIMAL ) 


l W l°| R | D ! C 1 


i i H i i i 


15,ADDR + 5 : DECIMAL AND CORE ADDRESS ( 


,3 , W f 0, 1 , , 


, , T, | , 


$A5,72,-16 :THIRD-WORDS / 


,3 , W, D, 2, , 


i i T, i i 


-6, $35, NINE : " I 


i3 ,W, D, 3, , 


i i T| i , 


1107,50,0 : " ) 


,6 ,W|0|R|D, 


I I S i i i 


$77,$A5,19,TAGG,-5,0 ' SIXTH-WORDS J 


,V ,A, R,I B,L 


i l G ■ i 


/)/2,VALU/16,$31/8,$A2/4, / 






39/6 : VARIABLE BIT FIELDS V 




1 1 ! ; 1 








_*^ - '^* S, ^ fc >-*_ J* ' ' ^* ' «" i 








U^~ — — •****^ ^* -"-■ *, Z^" """ 



FIGURE 15 
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2. Character Code Generative 



The Character Cod 
generate a word c 

TVi^ -Pi T> f +■ on"k_-Pn^ 
J-iiC -L J--L --3 U O i_/i. kJ J- j-C 

a decimal integer 
to be generated; 
a ted with any one 
left-most charact 
six 6-bit fields 
written character 



e Generation Function code SC -will 
ontaining six FIELDATA characters. 



i a 



U _1_ \J i.X 



to designate the number of words 
a maximum of 10 words can be gener- 

SC instruction. Starting with the 
er following the separating comma, 
from the successive groups of six 
s form the generated words „ 



Any of the FIELDATA characters, including those 
which normally serve a definite purpose in the cod- 
ing, such as the colon, dollar sign, comma, etc. 
can be used* A blank space is a valid character 
with this Function code, and must be considered when 
forming the 6-character groups. 

Examples of the SC instruction are given in Figure 16 



9 FUNCTION 14 



SUB FIELDS 



37 



I I I I 1 I 
|W|A|R|N|G| 

i I I I i I 



I l J i 



S,C 



iSiCi 



SiCi 



3, ASASIMPLEAASATHIS 



lg,NOTE:AMAXIMUM OF TEN 6-CHARAC : TER WORDS CAN BE GENERATED Wl 
4,TH ONE SC INSTRUCTION \ 



FIGURE 16 



3. Block Reservation 

The Function code RESV will reserve a block of words. 
The Label in the Tag field is the address of the 
first word of the reserved block. The sub-field may 
be coded as a decimal or octal integer, or as an Ab- 
solute Tag ± an increment, and is the number of words 
to be generated as zeros and reserved. This instruc- 
tion can be used at any point where word generation 
is allowed, ie., in either the instruction or data 
areas of the program. 
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Examples of the RESV instruction are given in 
Figure 17. 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS f 


.S.B.L.O.CK 




i R| E, S f V, 




48 




|T,B,L|0|C,K 


|R|E|S|V, 


$31 




,U,B,L,0,C,K 


i R, E| S i V, 


ABSTAG + 8 




I I i i I I 


! 1 i 1 1 

















FIGURE 1 7 
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V. DECLARATIVE INSTRUCTIONS 

A. Definition 

In general, Declarative instructions are instructions 
to the Assembler. They do not normally generate words 
in the object program. All Declarative Function codes 
are Assembler-defined (software) Functions. See Appen- 
dix C. 

Declarative Instructions can be classified in the follow- 
ing categories: 

Program Specification 

Equality 

Segmenting 

Table Definitions (core and drum) 

List Spacing Instructions 

Selective Jump Switch Definitions 

Macro-Instruction Definition 

Input/Output Definition 

Macro-instructions and Input/Output are discussed 
separately in Sections VI and XII respectively. 

B. Program Specification 

1 . The first line of every program must be a PRO in- 
struction. The Tag field of this instruction con- 
tains the name of the program, and must be left- 
justified . 

The PRO instruction requires one sub-field, which 
is coded with one of three Assembler -defined sym- 
bols which specify the object program format: 

ABS Absolute Binary (AOC) 

DIR ROC Direct I/O (DIRECT ROC) 

EXE ROC Executive I/O (EXEC ROC) 

The special comments of this instruction will be 
printed as the heading for each page of the listing, 
up to a maximum of 72 characters. A blank space is 
considered to be a valid character. 

2. The last line of coding of every program must be an 
■ ENDPRG instruction. The Tag field- is ignored by 

SLEUTH. The sub-field Is the address at which exe- 
cution of the object program is to begin. This 
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address must be in the instruction area of storage. 

Examples of the PRO and ENDPRO instructions are 
given in Figure 18. 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS / 


P.R.O.G, , A, 




iP,R,o, , 




ABS 




P ( R|0|G| | B, 


.P.R.O, , 


DIR 




p.R.o.g, ,c, 


,p,R,o, , 


EXE 




1 1 1 1 1 1 


E |N|D,P,R,0 


BEGIN 




1 l_J_l_l_l 


I I l 1 I 













FIGURE 18 



3. The program name is retained in its symbolic format 
in the ROC output of the Assembler. The program 
name is expanded to a 12-character left-justified 
representation. 

It Is used as the program name by both the Executive 
System and the Relative Load Routine to identify the 
program, and to indicate the base address of the ROC. 
For further Information see the manuals on the 1107 
Executive System and 1107 Relative Load Routine. 

C. Equality 

The "equals" Declarative serves the logical function of 
defining a Tag by assigning a value to it, or of re- 
lating two Tags. The Function field can be coded with 
either of two synonymous symbols: EQU or the "equals" 
sign ( = ). 

The coding in the sub-field defines the Tag or Label in 
the Tag field, and may be written as a decimal or octal 
integer, a Designator, or any type of Tag or Label. Mo- 
dification in the form Tag + increment is permissible. 
The Tag being defined assumes the type of the defining 
Tag, i.e., a Tag defined by a Data Table Tag also be- 
comes a Data Table Tag, etc.. 

The "equals" declarative is also used to define Tags 
-within other declaratives. In this case it is coded 
not in the Function field of the instruction, but in 
one of the sub-fields, and only the equals sign form 
(-) is permitted. A more detailed explanation of the 
latter use will be given in context. 
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Examples of the "equals" declarative are given in 
Figure 19* 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 37 COMMENTS \ 


l C l H l A l R l L l l 




! I EQU I 




CHUCK : TAG OR LABEL \ 


|D|S,G|I| | 


, |E|Q,U, 


$A3 : DESIGNATOR / 


,B|E|G| 1 ,N| 


i i E,Q ,U , 


START + 16 : LABEL + INCREMENT \ 


,C, 0, N, S,T, X 


• E Qu 


-48 : INTEGER / 


,0, 0, N, S, T,X 


1 1 1=1 1 


-48 ' " I 


J, A, B, L,C, 


DJ^^.L, E 


= TABLA,LGTHC = CONST + 42 := IN SUB-FIELDS / 


I I 1 1 1 I 


i i i I i 










V " 








- ' ' — ■■ ■ — 
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D. Segmenting Instructions 

Two instructions are available to control the place- 
ment of words in each bank of storage, and to segment 
the program. These instructions are IBANK, for the 
instruction area, and DBANK, for the data area. 

A Label coded in the Tag field of an IBANK or DBANK in- 
struction will have the same effect as if it had been 
coded In the Tag field of the first machine or genera- 
tive instruction following the IBANK or DBANK declara- 
tive. 

The format of the sub-field portion of the instruction 
will depend on whether storage of the segment on tape 
or drum is required. Where storage is not required, 
at most a single sub-field will be coded. 

For AOC type programs, the sub-field is coded with a 
decimal or octal Integer, or a previously defined Label 
or Tag + increment specifying the absolute address at 
which the next generated word is to be placed. If the 
sub-field is uncoded, the next available address will 
be assigned. 

For ROC type programs, absolute addresses must never 
be given to segments, and the sub-field is either left 
uncoded if continuation at the next available address 
is desired, or is coded symbolically, relative to some 
previously defined address of the same type of instruc- 
tion. 



SLEUTH 29 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 


37 COMMENTS 




iiiyiiiiiiiiiiiiiiiijliiiii 






HililllillH 

. i._ i i i i _ 

i > i B, A,N t K 




IIU BSOLUTE BINARY PROGRAMS Bill 


::::::::i::::::::x:::::::;:::::::::s:;j::::i:::::::::i::::i::^ 


::::::!:::ii!::i:!::!:llj 


_L_.L..J_L_L_i_. 
,S |T,A|R,T| 




$300 


: START =$300 




1 1 l l l 1 


. l' ( l E , T l C L> 
,1 |B,AiNiK 
i( |E|T|C|) 




1 1 1 1 1 1 


$300 






|S|T|A|R|T, 




:SAME EFFECT 




1 I 1 1 I l 


il iB|A|N,K 


START 


: START MUST BE PRE-DEFINED 






([111 




ipypiiiiipiiiiiii 






liiiROC TYPE PROGRAMS..'.,'' ;........:•• ' ■ • '* 


i i i i i i 


l I I I I 




: 




1S1T1A1R1T1 


1 iBiAiNiK 


: ASSEMBLER ASSIGNS NEXT LOCATION 


l I I i I i 


iCiE.T.C,) 




i i i i i i 


il iB,A,M,K 




|S,T,A,R,T, 


i( |E,T,C,) 


:SAME EFFECT 


I I I I i I 


I ! B, A,N,K 


START + 8 


: RELATIVE LOCATION 




I I l i i i 


i i i i i 




I s i E l G |M| T| 


A 
B 


_J|B|ANiK 
D B A N K 

111:1 


,TAPEQ # LGTI 


! STORAGE ON TAPE 




I s i e i g i m i t i 


,DRUM f LGTHI 


:DRUM STORAGE. DRUM TABLE LENGTH 




1 l 1 1 1 1 


TAG MUST ALSO BE LGTHI 


i 1 1 1 I i 


1 1 1 i 1 




_1_J L 1 .i_i . 


1 1 1 1 1 




1 I 1 1 1 1 


_ 


1 1 1 1 1 




I 1 1 i i i 


1 1 1 1 1 




1 1 1 1 1 1 


1 1 1 1 1 




1 1 1 1 1 1 


1 1 1 1 1 




1 1 1 i i i 


1 1 1 1 1 




1 1 1 1 l I 


1 1 i 1 1 




1 1 I l 1 l 


1 1 1 1 1 




1 1 1 1 1 1 


1 1 1 1 1 








1 1 1 1 1 1 


1 1 1 1 1 
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The first use of the IBANK or DBANK instruction sets 
the location of the. following instruction. The next 
use of the same instruction specifies continuation at 
the next available location following the preceding 
section of the same type. To accomplish this, SLEUTH 
maintains a pair of IBANK and DBANK "location counters," 
and increments these as required. 

The effect of an IBANK or DBANK instruction Is can- 
celled by the next IBANK, DBANK, or DTABLE instruc- 
tion. It is not necessary that all instructions of 
the same type be grouped together; an IBANK (and Its 
associated block of instructions) may be followed by 
a DBANK, then another IBANK, etc.. 

For segments requiring that the load routine be directed 
to store the segment on tape or drum, two additional sub 
fields must be coded. The first sub-field is coded as 
described in paragraph 1. above. The second sub-field 
will specify the tape unit or the drum address, and is 
coded as a Tape Unit Tag, or a Drum Table Tag. The 
third sub-field gives the length of the segment and Is 
coded as a Segment Length Tag. SLEUTH counts the number 
of words generated in' each segment, and assigns the ap- 
propriate value to the Segment Length Tag automatically. 
It can be referred to for the number of words of the seg 
ment . 

If drum storage is requested, the Drum Table Length Tag 
and the Segment Length Tag must be coded identically. 

A further discussion of Segmentation will be found in 
Section XI . 

Examples of the IBANK and DBANK instructions are given 
In Figure 20. 

E. Table Definition 

Tables can be stored in core memory, or on the magnetic 
drum. 

1 . Core Storage tables 

The DTABLE instruction defines a data table for ROC 
type programs, which is variable in length, In con- 
trast to the DBANK area which is fixed in length. 

The Tag field of a DTABLE instruction is a Data 
Table Tag, and is the name of the table. It repre- 
sents the address of the first word of the table. 

There are two sub-fields associated with this in- 
struction. The first sub-field sets the starting 
address of the table, I.e., defines the Data Table 
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Tag. If this sub-field is uncoded, the assign- 
ment of the address will be left to the Relative 
Load Routine. Coding is required only when it is 
desired to equate a data table to a previously de- 
fined data table, thus making their starting ad- 
dress the same. The coding consists of an "equals" 
sign followed by the previously defined Data Table 
Tag. 

An address within a Data Table can be referenced 
by one of two possible methods: 

Data Table Tag + Increment 

Data Table Tag + Data Table Length Tag 

The combined form: Table Tag ± increment + Length 
Tag is never permitted. 

If a Data Table Tag is defined as being equivalent 
to another Data Table Tag by means of a DTABLE in- 
struction, both Tags are primary Data Table Tags. 
If a Tag is equated to a Data Table Tag + increment 
by means of an EQU declarative, it is called a se- 
condary Data Table Tag. A primary Data Table Tag 
can be referenced by either method shown above, but 
a secondary Data Table is limited to the form: 
Tag + increment. 

The second sub-field is the Data Table Length Tag, 
and specifies the minimum number of storage loca- 
tions required to contain all the words generated 
for the table. It is modifiable at load time for 
ROC type programs. The following methods of coding 
are possible. 

(blank) 

= Absolute Tag 

= actual value 

Length Tag 

Length Tag = Absolute Tag 

Length Tag = actual value 

If the field is uncoded, a length of .zero will be 
specified. If the coding Is in the form: = Abso- 
lute Tag or = actual value, the length will be as 
specified by the Absolute Tag or actual value. In 
all three cases, no modification at load time is 
possible. 

In the other three cases, the minimum length will 
be as specified by the Absolute Tag or actual 
value, or zero if no equality is coded, and modi- 
fication at load time for ROC type programs is 
possible . 
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The Data Table Tag and the Data Table Length Tag 
are retained in the object program in symbolic form 
for the Relative Load and Executive Systems. 

A Data Table may be preset in the same manner as a 
DBANK area, by coding the data which "will comprise 
the table immediately folio-wing the table definition, 
Following the last coded data line, an IBANK, DBANK, 
or DTABLE instruction will signal the end of the 
current table. 

Further information on Data Tables will be found in 
the discussion of Library Subroutines, Section XIV". 

Examples of DTABLE Instructions are given in Figure 
21 . 




FIGURE 21 



2. Drum Storage Tables 

The MDT instruction defines a drum data table for 
absolute or ROC type programs. 

The Tag field of an MDT instruction is a Drum Table 
Tag, and is the name of the table. It represents 
the address of the first word of the table. 

For absolute type programs, the address of the Drum 
Table Tag may be specified by coding the first sub- 
field with a decimal or octal integer, or an Absolute 
Tag. Or a secondary Drum Table Tag may be equated to 
a primary Drum Table Tag by coding the sub-field with 
the "equals" declarative and the primary Tag. 

For ROC type programs, a drum table may be equated to 
another drum table as described in the preceding 



paragraph. 



;h< 



'ield is uncoded, the assign- 



ment of the starting address will be 
lati^e Load Routine. 



left to the Re- 
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Associated with each Drum Table Tag is the Drum Table 
Length Tag, which is written as the second sub-field. 
For absolute type programs it need not be coded un- 
less a reference to it is desired. It is then coded 
with the "equals" declarative followed by a decimal, 
or octal integer. 

For ROC type programs the Length Tag may be coded as 
an Absolute Tag, or an absolute length may be assigned 
by coding in the following format: 

Length Tag = value 

where the value is coded as an Absolute Tag or as a 
decimal or octal integer. 

The Drum Table Tag and the Drum Table Length Tag 
are retained in the object program in symbolic form 
for the Relative Load and Executive Systems. 

Examples of the MDT instruction are given in Figure 
22. 



1 TAG 7 


8 


9 FUNCTION 14 
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F. Listing Spacing Instructions. 

Two Instructions are available to control the format of 
the assembly side-by-side listing. They are coded In 
the body of the program at the point where spacing or 
ejecting is desired. They will have no effect on the 
assembly of the object program. 
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1 . To instruct SLEUTH to leave n number of blank 
lines in the listing, the SPACE instruction is 
coded in the function field, and n is coded in 
the sub-field as a decimal or octal integer. 

2. To instruct SLEUTH to cause a skip to the top of a 
new page, the EJECT instruction is coded in the 
function field. No sub-field coding is required. 

Examples of the SPACE and EJECT instructions are 
given in Figure 23. 
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G. Selective Jump Switch Definition 
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VI. MACRO -INSTRUCTIONS 

A. Purpose 

Macro-instructions provide a method -whereby a series of 
instruction or data "words can be generated by a single 
line of coding. A macro-instruction, once defined, can 
be used any number of times in a program, and for each 
use a different set of parameters can be coded, thus 
varying the function, data, registers, etc. of the 
basic set of instructions. 

Macro-instructions can be either system or program macro- 
instructions, "with the definitive coding on a separate 
input medium or coded directly into the program. 

A complete macro-instruction routine consists of two 
parts: the definitive set of instructions or "skeleton", 
and a single line of coding to generate the instructions 
or data for each macro-instruction. 

B. Defining a Macro-instruction. 

A macro-Instruction Is defined once, prior to any actual 
reference to It in a program. In defining a macro- 
instruction, a name is given to it which is a Label un- 
like any hardware or software Function code. 

Two declarative Function codes are used in the defini- 
tion of a macro-instruction. The symbol MACRO signals 
the Assembler that the Instructions which follow It are 
to constitute the skeleton. The name of the macro- 
Instruction Is coded in the Tag field, the Function 
code is the symbol MACRO, and no sub-field coding is re- 
quired. The symbol ENDMAC signals the end of each macro- 
instruction definition. No Tag or sub-field coding Is 
required . 

The skeleton is written between the MACRO and ENDMAC in- 
structions, and consists of lines of normal instruction 
coding, except that any variable fields are coded with 
parameter identifiers. These are decimal Integers, en- 
closed in parentheses, and ranging from 1 to the number 
of parameters involved. Each parameter identifier can 
be thought of as representing the nth parameter of the 
generative macro-instruction to which It applies. 

The sequence in which the parameters are coded, either 
In the skeleton or in the generative Instruction, is of 
no significance, as long as they are related properly 
to each other. Any field, except comments, can be a 
parameter . 
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Each parameter in the generative instruction replaces 
the corresponding parameter identifier of the associ- 
ated skeleton instruction on a character-by-character 
basis. Thus, any number, letter, or valid special 
character is permissible. Elements of the skeleton in- 
struction which are not parameter identifiers are re- 
tained . 

A Label should never be coded in symbolic form in the 
Tag field of a skeleton instruction, as it would be de- 
fined at each iteration. However, a parameter identi- 
fier may be coded in the Tag field and subsequently 
identified as a parameter in the generative instruction. 

C. Generating a Macro-instruction 

The set of instructions comprising the skeleton of a 
macro-instruction will be generated and inserted into 
the program by each generative macro-instruction. The 
coding line consists of an optional Label in the Tag 
field, the name of the macro-instruction in the Func- 
tion field, and the parameters required at each itera- 
tion coded in the sub-fields, arranged in the sequence 
specified in the skeleton. The parameters are enclosed 
in parentheses, and commas must not be used to separate 
parameters . 

D. Coding a Macro-instruction 

The coding of a macro-instruction is illustrated by the 
examples given in Figure 25a, 25b, and 25c. The basic 
macro-instruction is labeled MAC2, and contains within 
itself references to three other macro-instructions: 
MAC1 for data, and MAC3 and MAC*+ for additional func- 
tions. MAC3 and MAC^ will not be coded as separate 
lines of instruction coding, but will be generated 
automatically as a result of parameters (5), (6), and 
(7) of MAC2. Both MAC3 and MAC^ must still be defined, 
however. Note the parameter identifiers: the 6th 
and 7th parameters of MAC2 are first translated to 
( Ak ) and (TESTA) in the first iteration, and these in 
turn become A 1 ! and TESTA, without parentheses, the 
parameters of MAC3. 

The notes in the comments field of the example, Figures 
25a, 25b, and 25c are explained below: 

Note 1: Parameter (5) is defined by the generative in- 
structions as LABLA and LABLB for the two iter- 
ations of MAC2. MAC2 can thereby make refer- 
ence to the data of MAC1 . 

Note 2: A function field can be one of the parameters. 
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Note 3 : An entire macro-instruction can be coded as 
parameters of another macro-instruction. 

Note k: MAC1 generates data words. The parentheses 
enclose a complete sub-field in the form in 
which it would have been written in straight 
programming . 

Note 5' MAC2 generates instruction words. 

Note 6: MAC3 and MAC^+ are defined with MAG2. Since 
the parameters are first translated as MAC3 
(A*+) (TESTA), double parentheses are required 



SLEUTH 38 





1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 


37 COMMENTS 


NOTES 




i |M,A,C|I| 




m jAi c j_ r i°i 






1 




, I (5) i , 


(1) 








i i I I i I 


i ,w, , , 


(2) 








I l I i i I 


i l s l c l 1 


(3) 










. |H, , , 


(4) J 








E,N|D,M|A,C 








I i M l A l C l 2 i 


M,A,C, R,0 , 








1 I I 1 1 1 


l L l D l P l 1 


0),(2) 










|A,D|D| | 


(D,(3) : 








. M) , , 


(1),(8) + 1 


: 


11 & 2 






, (5) , , 


(6) (7) : 


3 


£ 

H 




E ,N, D,M|A|C 






W 


i |M, A, C, 3, 


M , A, C,R ,0, 










i s l u i B l I 


d),(2) 










i*i R i J i p i 


(D,NG : 








, J , U, M,P , 


, OKAY 








1 1 1 1 1 1 


EjNiRiMAlC 

M , A, C, R 0, 








i |M ( A, C, 4, 










,*,R| J.P, 


d),NG 


: 








J U MP, 


, OKAY 


! 








E ,N t D , Mj A , 


: 








I 1 l I I 


s 










: 








1 l l I I 


: 












9 










* 










: 












J 








1 I I I I 


* 
• 








l I I i I 


• 





FIGURE 25a 





1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 37 COMMENTS 


NOTES 




1 1 1 1 1 1 




llilllllilllll 

1 1 1 1 1 




■■■IF IRS T ITERATION CODING;.. i 
















_. 1 1 1 1 1 1 
I 1 1 1 1 1 


,M|A,C,2, 


(325) (750T) ( 1/FI L E A) ( 1 , 0) ( L A B L A) : : 




4 




($A4)(T0TALA)(ITEMA)(SUB) 




5 




1 1 1 1 1 1 


l 1 I 1 1 


(MAC3) (($A4)) ((TESTA) (LABLA): s 




6 




i! ••!•:• J." |:.\.IlJLL 
1 1 1 1 1 1 


T^:^k^ninl::=i»!:=:i::= 








•.GENERATED AS I;;i=:I::llll=li-li:=!:I!ii::Ii-Ii : =;-I- • : 


' .'..'." • 7 : ;'•" ...: ' .= .••-."•'• 






1 1 1 1 1 










,L, A, B, L t A, 


I , ,w, , 


325 : 


MAC! STARTS HERE 






1 I I l I 1 


1 i ,w, , 


750 s 






CO 

t" 1 


l i I i i l 


1 l s l w l 1 


1/FILE : 






czj 


l l I I I I 


I I i Mi i 


1,0 ' 






M 


__L J 1 l 1 J 


i iL|D,P, 


$A4,TOTALA 


MAC2 STARTS HERE 




-r 
o 


_1 L 1 L_L_L .. 


l [A | D| D, 


$A4JTEMA 








1 1 I 1 1 1 


> |S|U|B, 


$A4 , LABELA+1 








1 1 1 1 1 1 


i |S|U, B, 


$A4 f TESTA 


' MACS INSERTED HERE 






1 1 1 1 1 1 


_jJSi_R_i_JlPi__ 

i J|U M ; P| 


$A4, NG 








1 1 1 1 1 1 


, OKAY 








1 1 1 1 1 1 


1 I I i i 










1 1 1 1 1 1 


I I I i j 










1 1 1 1 1 1 


l I i i i 










i 1 1 1 1 1 


i 1 I i i 












1 1 1 1 1 1 


i i i i i 












1 1 1 1 1 1 


1 I I I 1 










1 1 1 1 1 1 


l 1 I i i 










I 1 1 1 1 1 


1 1 ! 1 1 










1 1 1 1 1 1 


1 1 i 1 1 










1 1 1 1 1 1 


1 1 1 1 1 










1 1 1 1 1 1 


1 1 1 1 1 










1 1 1 [ 1 1 


1 1 1 1 1 









FIGURE 2 ^b 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 


37 COMMENTS 


MOTES 


I^SllBllil 




1 1 1 1 1 




llllll SECOND ITERATION CODING I|||f f § 


'^^^^^^^^^^^^^^^^^^^^^^^^^^^X 




i i i i i i 


: 




i i i i i i 


.M.A.C.l, 


($177) (1250) (1/FILE B ) ( 1 , 9) ( L A B L B) : 


j 


4 


i i i i i i 


,M,A,C,2, 


($A2)(TOTALB)(ITEMB)(ADD) 


5 


i i \ i i i 


1 1 1 1 1 


(MAC4) (($A2)) ( ) (LABLB) : 


» 


6 


■ i < ■ i i 


I 1 1 I 1 


: 








II1||g e n e r a t e d as 


'"•'•'£•• '•;'.:/'.'• ':..; : -.-. •• .' • 




i i i i i i 




1 1 1 1 1 






o 




,L i A, B,L,B, 


1 1 l W l 1 


$177 


: MAC1 STARTS HERE 




1 I i I I I 


1 1 1^1 1 


1250 


:: 




l i l i i l 


1 I S 1 C l l 


1/FILE B 


: 




l I I I I i 


l I i H| i 


1,0 


J 




I I i I i i 


i |L|D|P, 


$A2,TOTALB 


: MAC2 STARTS HERE 




1 I I 1 I i 


I |A|D|D, 


$A2,ITEMB 


• 




i i i i i i 


, i A, D, D, 


$A2,LABLB + 1 


• 







i*i r i J i p i 


$A2,NG 


: MAC4 INSERTED HERE 




i 


J UM i P - 


,OKAY 


• 
• 




i i l i i i 


i i i ; i 


: 




I i l 1 l i 


i i i i i 


: 




I 1 1 1 I i 


1 1 1 i ! 


• 




1 1 1 1 1 1 


i i i i i 


• 
• 




I I l I i I 


i 1 i i i 


* 




i 1 l i i i 


I i i I I 


: 




1 1 1 1 1 1 


i i i i i 


: 




1 I I 1 I i 


i i i i i 


• 




1 1 I i i i 


i i i i i 


• 
• 




1 1 1 1 1 1 


iii 


• 




I i i i I i 


i i 1 i i 


• 
• 




1 i I I i I 


i i i i i 


• 




1 1 1 1 1 1 


i i i i i 


• 
• 





FIGURE! 2^c 



VII. CORRECTIONS 
A. Purpose 



Corrections to the source program can be made by means 
of a correction program, produced on a separate input 
medium (cards, paper tape or magnetic tape). They will 
be merged "with the source code Input of the program 
which is to be corrected, during the first Assembler 
pass, and must therefore be in the same sequence as the 
main program. 

Coding 

The special declarative instructions which direct the 
Assembler in making corrections and which are used only 
in the correction routine, are discussed below. They 
are coded in the Function field. 

1 . COR 

The first Instruction of the correction input is 
the COR instruction. The Tag field of this instruc- 
tion contains the name of the program to which the 
corrections are directed, written exactly as in the 
PRO instruction of the main program, including left 
justification. No sub-field coding is required. 

2 . DELETE 

Three forms of the DELETE instruction are possible: 

a. Coding an asterisk in the sub-field of the 

DELETE instruction will delete all instruc- 
tions in the main program which were prefixed 
by an asterisk, as previously described In 
Section III. paragraph A. 

When this form of the DELETE instruction is 
used, it must be written immediately following 
the COR instruction. 

Instructions which are added by means of the 
correction routines may be prefixed by asterisks, 
and such instructions will remain, to be deleted, 
if desired, at some future Assembler pass. 

b. A single instruction may be deleted by coding 
the Label of the instruction, or the previous 
Label modified by a positive increment, or the 
item number (see Section IX), in the sub-field. 
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Any number of new instructions can be inserted 
in place of the deleted line by coding them on 
the correction input immediately following this 
form of the DELETE instruction. The replacement 
will be halted by the next corrective declara- 
tive. 

The DELETE instruction will delete a block of 
instructions if the lower and upper limits are 
coded in the sub-fields as Labels or item num- 
bers. If modified Labels are used, the incre- 
ments must be positive. 

Substitution of new instructions is effected 
as described in paragraph B.2.b. above. 



3 . FOLLOW 



Any number of lines of coding can be inserted, with- 
out deletion of an x; existing instructions- by codln^ 
such instructions immediately following a FOLLOW in- 
struction. The sub-field of the FOLLOW instruction 
must contain a Label or item number representing the 
instruction which will be followed by the new in- 
structions. If a modified Label is used, the incre- 
ment must be positive. Insertion of new instruc- 
tions will be halted by the next corrective declara- 



k. ENDCOR 

The last Instruction of the correction Input must 
be an ENDCOR instruction. No Tag or sub-field 
coding is required. 

C. Precautions 

The programmer should exercise caution to insure that 
the main program is net adversely affected by any cor- 
rections. For instance, modified addresses of the 
&L+5 type will definitely be affected if any deletion 
or addition occurs between $L and $L+5, and a reference 
to $L+5 in the corrected program might not be the same 
as in the original program. 

Corrections must not overlap. 

PRO and ENDPRO instructions in the main program should 
not be prefixed with an asterisk. They can be indivi- 
dually deleted and replaced with new instructions. The 
Assembler checks to insure that the deletion of either 
is accompanied by a corresponding insertion. 

In general, any line of coding which has an item number 
associated with it can be corrected. 

Examples of correction programming are given in Figure 
26. 
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VIII. ACCIDENTAL SYMBOL DUPLICATION 

A. Purpose 

It is always preferable to have all Tags and Labels com- 
pletely unique, but since accidental duplication of sym- 
bols can occur, a method is available to provide some 
protection against such a contingency. 

B. Method 

The program can be divided into sections by means of an 
SEC instruction. No Tag field or sub-field coding is 
required. A SEC instruction is not required at the be- 
ginning of a program, since the first part of a progrmm 
automatically becomes the first (or only) section. All 
instructions which follow an SEC instruction become a 
part of that section. The effect of an SEC instruction 
is terminated by another SEC instruction, or by the end 
of the program. 

If a Tag is defined only once in a program, this defi- 
nition will prevail throughout all sections of the pro- 
gram. This definition can occur in any section. If a 
tag is defined in more than one section, It will be 
assumed to be an accidental duplication, and the defi- 
nition in a section will apply to that section only. 
Hence, reference to a Tag should never be made outside 
the section which contains its definition, unless it 
Is absolutely certain that only one definition of the 
Tag exists for the entire program. 

The rules for coding of Tags and Labels for programs 
making use of the symbol duplication feature are illus- 
trated in Figure 27. The numbered notes in the comments 
column are explained below: 

Note 1: This Tag is acceptable, since it is defined in 
the section in which it appears. The symbol 
ALICE appears in all three sections, either as 
a Label or as a Data Table Tag. Each section 
generates a different value for ALICE. 

Note 2: Since BONNY and DOTTY are defined only once in 

the entire program, any reference to these Tags, 
in any section, is acceptable. 

Note 3: CHRIS In section 3 is incorrect, since It is 

not defined in this section, but is defined in 
sections 1 and 2. CHRIS will be generated as 
as two different values in sections 1 and 2. It 
will be generated as ^ero in section 3, and an 
error indication will appear on the program 
listing . 
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IX. ASSEMBLY LlS'l'lNtt 

SLEUTH will automatically produce a listing of each as- 
sembled program to provide a record of its interpretation 
of the Source program. The only programmed control over 
the listing is the spacing as described in Section V, para- 
graph F. 

The listing consists of three principal sections: 

A. Title Line 

The first line shows the program name as it appears in 
the PRO instruction of the source program. At the cen- 
ter of the page, the word "LIST" appears 3 followed by 
the date. 

B. ROC Auxiliary Information 

The contents of the following are listed: 

1. Facility record. 

2. Directory record. 

3. Modification record. 

For the uses of the above, refer to the manuals on the 
Relative Load Routine and the Executive System. 

C. Body of the Listing 

The source program and the assembled object program are 
listed side by side. For generative instructions the 
generated word is printed in an expanded octal format. 
Values associated with declaratives are listed, e.g., 
the value assigned to a tag by the Equals declarative. 

An item number Is assigned to each line of coding and 
appears on the listing. As previously mentioned in 
Section VII, the item number may be used to identify 
lines of coding for corrections. 

Coding errors detected by SLEUTH -will be listed as 
error codes. 
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X. RELOCATION 

Assembled object programs can be in AOC, DIRECT ROC, or 
EXEC ROC form, as specified In the PRO instruction. 

Absolute output is in binary form, ready for loading and 
execution. 

For ROC type programs, fields within some generated words 
are necessarily incomplete. Final assignment of absolute 
addresses and I/O units will depend upon the Relative Load 
Routine and the Executive Routine at load time. 

When ROC output is specified at the beginning of a program, 
SLEUTH will produce the data required by the Relative Load 
Routine to effect proper modification and relocation. 

Coding special tags in a field gives to the Assembler the 
information necessary to construct modification indicators 
describing how a field is to be modified. The Assembler 
also produces, as a part of the ROC format, tables defining 
the special tags. From this information the load routine 
can modify each word and make the program ready for execu- 
tion. 

The Table In Appendix F gives the fields within each word 
which may be modified on loading if necessary. The possi- 
ble forms of coding which may be used to generate the 
field are also listed. 

Field 29-00 is an unnatural division of a word which Is used 
as part of the calling sequence for the Executive I/O pack- 
age. Both the unit or drum address and channel assignments 
are inserted in the field at load time. 

Actual modification to the 30-bit field is restricted to 
bits 29-26, and 22-00 for drum addressing or T 5-00 for unit 
assignment. Within a word two combinations of these modi- 
fiable fields may occur: 

Field 25-22 and 15-00 
or 33-18 and 1 5-00 

Complete Information on modification and relocation will be 
found in the separate Relative Load Routine manual. 
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XI. SEGMENTATION 

All three types of binary output can contain segmented 
programs. After initial loading of the program by the 

the program itself must read segments. Information neces- 
sary to read a segment should be available within a pro- 
gram being assembled, using unit tags, drum table addresses 
and length tags. Instructions must be generated to perform 
this reading. 

An analysis of the operation of the 1107 Relative Load Rou- 
tine should make clear the situation that exists at the be- 
ginning of execution. The words generated for a segment 
are modified if necessary (i.e., for ROC type binary output) 
and loaded in core at the execution position. For each 
IBANK or DBANK area a single block is written on tape or on 
drum if storage was specified. Any section not requiring 
storage remains in core, and the initial operating section 
must therefore come last, or not be written over by a suc- 
ceeding section. 

Sections stored on drum do not necessarily have ascending 
drum addresses, but each table name gives the beginning 
location of storage. Block markers are not written on 
drum. Storage on tape will be in blocks in the order of 
original coding. The first and/or last word of a section 
generated can be used as a search word to locate the seg- 
ments . 
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XII. INPUT/OUTPUT 

A. General 

Assembled object programs can be In AOC, DIRECT ROC, or 
EXEC ROC form, as specified in the PRO instruction. Each 
type differs in the method of programming for input /out put 
operations, and each is discussed separately in this sec- 
tion. 

For AOC and DIRECT ROC type programs, all Input/output 
instructions must be coded in detail,, using the four 
types of I/O instructions as required: 

1 . Computer Hardware I/O Instructions 

These instructions are functions performed by the 
computer to initiate input/output, or function modes 
etc. A full list -will be found In the Computer In- 
struction Repertoire, Appendix B; they are identi- 
fied by the octal Function code 75* 

2. I/O External Function Instructions 

These instructions are functions performed by the 
peripheral equipment, such as Rewind Tape, Read 
Drum, Punch Card, etc.. A full list will be found 
in the I/O Function Repertoire, Appendix D. 

3. I/O Generative Instructions 

These are software instructions which are used to 
generate external Function words and Access Control 
words. See Appendix C.I. 

k. I/O Declarative Instructions 

These are software instructions which are used in 
channel and unit definitions. A full list will 
be found In Appendix C.2. 

B. Requirements for Programming Input/Output 

Each input/output operation involves some I/O channel, 
and some I/O unit of peripheral equipment, both of 
which must be assigned, either absolutely or symbolical- 
ly, by the source program. In addition/ the actual ope- 
ration to be performed must be stated by means of Exter- 
nal Function words and I/O Access-Control words. 

A channel or unit can be defined without being specified, 
i.e., a line of coding will be written to indicate that 
such a channel or unit is required, but no specific iden- 
tification is stated. 
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C. AOC 



For AOC type programs, all input/output instructions 
must be coded in detail, and all assignments of I/O 
channel, units, drum addresses etc. must be coded in 
absolute . 

1 . I/O Channel Definition and Assignment 

An absolute Channel Assignment is made by coding a 
decimal (00-15) or octal (00-1 7) integer, or a pre- 
viously defined absolute Channel Tag as the first 
sub-field of a Computer I/O instruction. 

A Channel Tag is a symbol of not more than 5 char- 
acters, and is defined by means of a Channel Defi- 
nition declarative instruction. The Channel Tag 
is coded in the Tag field, the Channel Definition 
declarative Is coded in the Function field, and an 
absolute eouatlon of the Channel Tag with channel 



n 



is made by coding the sub-field as: =n. 



I/O Channel Assignment and definition is illustrated 
in Figure 28. 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 37 COMMENTS 


1 1 1 1 1 1 




II PM, 




1,ABC : ABSOLUTE CHANNEL ASSIGNMENT 


1 1 1 1 1 1 


1 1 1 1 1 
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= 2 : ABSOLUTE CHANNEL DEFINITION 
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FIGURE 28 



2. I/O Unit Definition and Assignment 

An Absolute Unit assignment is made by coding a 
decimal or octal Integer (up to the maximum number 
of I/O units associated -with any given channel), 
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or a previously defined absolute Unit Tag In the 
p-field of an External Function word. 

A Unit Tag is a symbol of not more than 6 charac- 
ters, and is defined by means of a Unit Definition 
declarative instruction. The Unit Tag is coded in 
the Tag field, the Unit Definition is coded in the 
Function field, and an absolute equation of the 
Unit Tag with Unit "n" is made by coding the sub- 
field as: = n. The generated value will be in 
master bit format. 

I/O units are grouped by I/O channels by defining 
all the units associated with a given channel 
immediately after the channel definition. 

The unit definition declarative may be suffixed 
with the letter to indicate that such units are 
optional, and may be deleted at load time. 

I/O unit assignment and definition are illustrated 
In Figure 28. 

3. I/O Access Control Words 

The actual word-by-word transmission of input data, 
output data, or external function words between 
the Computer and the peripheral equipment is governed 
by I/O Access-control words stored in the Access- 
Control Registers. These Registers are two groups of 
film-memory locations specifically assigned as follows 

^-0-57 (octal) Input Access-Control Registers 
60-77 (octal) Output Access-Control Registers 

Location ^0 is the Input Access-control Register for 
Channel 0, location *+1 is the Register for Channel 
1, etc.. Similarly, location 60 is the Output Access- 
control Register for Channel 0, location 61 is the 
Register for Channel 1, etc.. 

To generate Access-control words, two possible in- 
struction formats are available, as Illustrated in 
a generalized form in Figure 29. 



1 TAG 7 



9 FUNCTION 14 



SUB FIELDS 



37 



COMMENTS 



I I I* 



I I f* I I 



L^" 



19 I I I 



9>w,v 



METHOD 1 



METHOD 2 



FIGURE 29 
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The Tag field, t, is coded with a Label, or it may 
be omitted. The letter A used in method 1 is an 
actual generative Function code. The increment 
designator g will generate a two bit binary field 
into positions 3^-35 of the Access-control word- 
and is coded as I, D, N, or ND: 

I = 00 Increment u address 

D = 10 Decrement u address 

NT = 01 Inhibit Increment 

ND = 11 Inhibit Decrement 

The word count, w, is coded as a decimal or octal 
integer, or an Absolute Tag. The address, u, Is 
coded in any acceptable u-field format. 

An Access-control word is set up in an Access- 
control Register by coding the core address of the 
word in absolute or symbolic form as the second sub' 
field of an appropriate Computer I/O instruction. 
See Figure 28. 

Examples of the coding of Access-Control words are 
shown in Figure 30. 
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9 FUNCTION 14 
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SUB FIELDS 


37 COMMENTS / 
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i |A, , , 




0,56, $6880 


' METHOD 1 _ ABSOLUTE J 


1 1A1B1C1 i 


! lAl 1 1 


1 . W D C N T , R B L C K 


: METHOD 1- SYMBOLIC f 
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i i i > i 
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i |B,C|D| i 


1 


56,RBLOCK 


: METHOD 2 - INCREMENTING / 


. ,C,D,E, , 


i i">i l I 


5,AREAB 


: METHOD 2 - DECREMENTING \ 


l I 1 i l i 


1 1 ! 1 1 


; 








—— \ 



FIGURE 30 



k. I/O External Function Words 

I/O Function Words are actually Instructions forming 
the repertoire of the various types of peripheral 
equipment. A list of the functions for each type of 
equipment will be found in Appendix D. Any of the 
instructions may be modified by prefixing the Func- 
tion code with the letter I, which will produce a 
monitoring effect by causing an external interrupt 
signal to be emitted by the peripheral equipment at 
the normal conclusion of the operation. 



SLEUTH 53 



As far as .the Central Computer is concerned, these 
external function instructions are treated simply 
as data words. They are generated by an I/O Func- 
tion generative instruction, which can be coded in 
either of the two possible methods shown in a gener 
aliped form in Figure 31 . 



9 FUNCTION 14 



SUB FIELDS 



37 



1 11 *1 1 1 



i I I I i 



I I I I I I 



l T i i i 



f,P,x 



METHOD 1 



METHOD 2 



FIGURE 31 

The Tag field, t, is coded with a Label, or it may- 
be omitted. The letter F used In method 1 is an 
actual generative Function code. The letter f re- 
presents the appropriate Function code for the 
peripheral unit. The letter p represents the unit 
assignment, and is coded either as a Unit Tag, or 
as a decimal or octal integer, written in a form 
which will produce the same master bit configura- 
tion as the Unit definition declarative would pro- 
duce. For example: Unit 3 should be coded as $*+, 
for a bit configuration of 100; Unit 5 should be 
coded as $20, for a bit configuration of 010 000, 
etc. . 

The letter x represents a third field which is re- 
quired in some functions, such as printer line 
spacing. The field is coded with a decimal or oc- 
tal integer, or an Absolute Tag, with values 
ranging from to 63. 

Examples of the coding of External Function words 
are shown in Figure 32. 




FIGURE 32 
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D. DIRECT ROC 

AOC and DIRECT ROC type programs are essentially simi- 
lar in their basic programming requirements. For both 

f "r«A n ol 1 i nnnf /nnf nnf 'imQ-{-r»i-ir» , |-n/^mc 1 mnpf V\r« r* r\ r\ r\ A n n 

U ¥ M >^ W * U 4-J- il±k^U«J/ O'uiuUUu j_iiO <Ji Ui.U yj-viiw j_Ll IaO vi KJ ^ O ^>-' <A ^ '^>L J- i. -L 

detail, using the four types of I/O instructions pre- 
viously discussed in paragraph A of this section. 

The chief point of difference between the two types Is. 
that in DIRECT ROC programs, final assignment of memory, 
I/O channels, units etc. may be made through the Relative 
Load Routine, 

Thus in the source program, such assignments can be 
either specific or relative. If the assignments are 
specific, they will be honored by the Relative Load 
Routine at load time unless modification is desired, 
and such modification will be governed by the Location 
Input records associated with the Loader. A symbolic, 
or unspecified, assignment in the source program re- 
quires Location Input data with the Loader so that 
final assignment can be made. 

Absolute or specific assignments are made as described 
for AOC type programs. Symbolic assignments are made 
by omitting the field in the coding line which speci- 
fies the absolute value of the channel, unit, etc.. 
For example, in a channel or unit definition instruc- 
tion (see Figure 2R ), the sub-field would be left 
blank, and not equated to some specific channel or 
unit. Similarly, in the generation of an External 
Function word (see Figure 30), the input /output unit 
designated by the p-field should be coded in symbolic 
form. 



The word count in Access-control words should, of 
course, be coded as an actual value. 

For a detailed explanation of load time operations, see 
the manual on CLAMP, the Relative Load Routine. 

E. EXEC ROC 

Input/Output programming for EXEC ROC type programs 
differs completely from the programming for AOC and 
DIRECT ROC. The Computer hardware instructions and 
the External Function instructions are not used; in- 
stead, an instruction repertoire consisting of a set 
of Executive System pseudo-instructions is used. 
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For EXEC ROC, all I/O channel and unit assignments 
must be made in symbolic form. They will be assigned 
absolute values at load time by the Executive System, 
working through the Relative Load Routine. 



Channel Tags are not required in defining I/O Channels 
for EXEC ROC, and a specific channel designation must 
not be given. Therefore, a complete channel definition 
can consist of only the channel definition declarative 
coded in the Function field. There Is one exception to 
the rule about specifying channels: If a channel is 
specified as: = 0, then EXEC? the 1107 Executive 
System, will assign the I/O units grouped under such 
a channel to any available channels. 



are defined, by channels, as 
ROC 



described for 



I/O units 

AOC and DIRECT ROC, except that again no unit specifi- 
cation can be made. The Executive System will attempt 
to assign tapes classified as input tapes to units 
which currently do not contain a physical tape, thus 
minimizing operator effort. 

I/O Access-control words form a part of the I/O Packet 
and are coded as previously described. 
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A complete list of all Executive System pseudo- func- 
tions, as well as a description of the format of the 
I/O Execution Packet and the manner in which an I/O 
request is submitted to the Executive System, is con- 
tained in the manual on EXEC, the 1107 Executive 
System. 
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XIII. SPECIAL DATA TABLES 

Two special tables can be defined for EXEC ROC type pro- 
grams by giving them special names as described below. 

A. $PARAM 

The table named $PARAM will receive the input from the 
Parameter Cards which are a part of the Executive Sys- 
tem Job Request. Each card contains 11 words, and ac' 
cordingly the table lengths will normally be multiples 
of 11 . 

b . Terror 

The table named $ERR0R is recognized by the Executive 
System as a table of eight addresses corresponding to 
the eight error interrupt locations (300~377 8 ). If 
an error occurs during the operation of the program, 
the Executive System will consult the proper address 
entry, place the P-register value at the time of the 
error in the location specified, and jump to the 
following word. Simulation of direct use by the pro- 
gram of the error interrupts is thus accomplished. 
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SEGMENTED COMPLEX PROGRAM 



BANK1 



CSRl 






CSR2 




CSR3 




MC 




SI 








S2 






SRI 






SR2 






SRI 












SR2 





SN 



SRI 



SR2 



SR3 



CSR = common subroutine 

MC = master control 

S = segment 

SR = subroutine 

D prefix denotes data 



BANK 2 



DCSRl 



DCSR2 



DCSR3 



DMC 



DS1 



DSR1 



DSR2 



DS2 



DSR1 



DSR2 



DSN 



DSR1 



DSR2 



DSR3 



Associated Data Tablea Not Shown 



FIGURE 3^ 
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XIV. LIBRARY SUBROUTINES 

A. General Information 

A Drogram requiring the addition of subroutines from 
an external library is called a main program. A main 
program, together with its associated subroutines, is 
called a complex program. Complex programs, as well 
as simple programs (i.e., programs with no associated 
subroutines) may or may not be segmented. Figure 3^ 
illustrates the form of a segmented complex program. 
The inclusion of subroutines can be done either at as- 
sembly time or at load time. 

In general, each subroutine defines its needed I/O 
equipment, and drum or core tables, which are then 
equated to tags in the main program. The assignment 
of common I/O equipment, drum and data tables, and the 

use of multiple entry points allows considerable freedom 
in the design of subroutines. The methods used, there- 
fore, to communicate between the main program and the 
subroutine, or between subroutines, will be to a great 
extent dependent on the programming standards estab- 
lished at each UNIVAC 1107 Computer installation. 

If the subroutine is to be included at assembly time, 
Its position within the main program is specified. If 
the call for the subroutine is at load time, It is 
added to the end of the main program. 

B. Assembly Time Inclusion 

Subroutines which are to be inserted Into a main pro- 
gram at assembly time will be in symbolic notation on 
a library tape, and the format will be that of a macro- 
Instruction skeleton. The actual generation and in- 
sertion are effected by an instruction in which the 
name of the subroutine is used as the Function code. 
Any required parameters are coded in the sub-fields 
portion of this instruction. 

In general, subroutine inclusion at assembly time is 
handled in exactly the same manner as the use of macro- 
instructions, except that the definition and skeleton 
appear on the library tape and not in the main program. 

C. Load Time Inclusion 

Subroutines which are to be added to a main program at 
load time will be in a modified ROC format on a library 
tape. 
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A main program requiring subroutines at load time must 
specify the subroutines and the various entry points 
required by means of the XREF declarative. Figure 35 
illustrates such an external reference to two subrou- 



o ~^j kj • 



iiiUJ- O iJJ J.C 
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the subroutine TRIG. The subroutine name (TRIG) is 
automatically an entry point. SQRT is a subroutine 
■with no additional entry points. 
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The main program coding required to enter a subroutine 
Is dependent on the manner in which the subroutine is 
written. 

Main program coding should observe the following con- 

1 . All segmentation is handled within the main pro- 
gram. 

2. The required subroutines are specified by means of 
an XREF declarative in each main program segment if 
more than one segment exists. Any subroutine speci- 
fied in a section always in core is considered a 
common subroutine, and may be referenced by any sec- 
tion of the program. Subroutines placed within a 
program segment which has been stored on drum or 
tape can be referenced only by that segment. 

3. The total requirements of the subroutine data 
tables must be contained within the data tables 
specified for the main program. 

*f. Similarly all drum tables and I/O equipment must 
be specified for the total configuration needed 
by the main program and subroutines. 

5. A facility record must be made up which describes 
the total requirements of the combination of pro- 
grams. 
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D. Creating a Subroutine 

Subroutines, whether they are to be added at assembly 
or load time, must be coded within the following limi- 
tations : 

1 . Subroutines are never segmented; the main program 
controls segmentation. 

2. The subroutine consists at most of one IBANK and 
DBANK area, and one set of data tables. 

3. A subroutine may itself contain an XREF declarative 
cross-referencing other subroutines, if required, 
i.e., subroutines within subroutines. 

k. A subroutine may have several entry points which 
are defined by the ENTRY declarative. The various 
entry points are coded in the sub-fields portion of 
the ENTRY instruction and each entry point label 
so defined will appear on the Directory Record so 
that in adding subroutines each entry point may be 
an entrance from other programs. More than one 
ENTRY declarative can be used; their effect is 
cumulative. The subroutine name is automatically 
an entry point. 

See Figure 36 for an illustration of the ENTRY de- 
clarative. 



TAG 



I 



9 FUNCTION 14 
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FIGURE 36 
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XV. SAMPLE PROGRAM 

A. Statement Problem 



The sample problem given here "will evaluate the ex- 
pression 

f (x) = x 3 + ax 2 + b C 2 ^-) - c 

The values of x range from to 999 in steDs of 1 . 
200 sets of random values for a, b, and c are assumed 
to be stored in a drum table, each set consisting of 
three words containing the values for a, b, and c, 
making the total length of the drum table equal to 
600. The arrangement of the drum table is: 
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stored 


in 


ABC 






i 
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stored 


in 


ABC 
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i 
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ii 
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ABC 


+ 
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!! 
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ABC 
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II 


ii 


ABC 
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2 
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II 


I! 


ABC 
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5 


2 












a 


II 


II 


ABC 


+ 


6 


3 













etc . 

x +b 

The expression within parentheses (J- J? ) will be handled 

as a macro instruction. 

Figure 37 is a flow chart of the problem, and figure 38 
Illustrates the coding. 

B. Method of Solution 

The method used in the sample program is to evaluate 
f(x) for a , b , and c , and < x < 999, write 1000 

results on tape, then solve for a , b , c , etc., until 

2 2 2 

the results for the 200 sets of values of a, b, and c 
have been written. 

The explanations given below refer to the corresponding 
number in the comments section of the written program. 

1 . The program name is EPFEX, and the object program 
will be an EXEC ROC type program. 

2. The symbol XREG is equated to Register B2, and 
any reference to XREG is a reference to B2. 
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3. A single blank space "will appear on the program 
listing at this point. 

k. The heading "I/O DEFINITIONS" Is an extension of 
the previous instruction, and must therefore have 
no Instruction terminating colon of its own. 

5. DRUM1 is defined as a magnetic drum channel, but 
since this is an EXEC ROC type program, no specific 
channel identification is made. 

6. ABC is defined as a drum table on some unspecified 
drum unit. The length of the table is 600. 

7. OUTPUT is defined as an unspecified tape channel. 

8. TAPE1 is defined as an unspecified tape unit. 

9. TABC is defined as a data table in core, with a 
length of 3 "words, and with an unspecified start- 
ing address. It represents the 3 core addresses 
into which will be read, from the drum table, the 
3 words representing the values of a, b, and c. 

10. TOUT is a data table in core, which will be used 
to contain the 1000 results calculated for each 
set of a, b, and c values, and from which these 
results will be written on tape. 

11. MACA is the name of the macro instruction whose 
skeleton is defined by the instructions coded 
between the MACRO and ENDMAC instructions. 

12. The instructions which follow the IBANK line will 
be stored in the instruction bank of core storage 
(see comment #23). Because of the previous EJECT 
instruction, the coding lines beginning with the 
IBANK instructions will be printed on a new page 
of the program listing. 

13. START is the symbolic address of the first actual 
instruction of the program. The instruction will 
place the actual value 199 in Register Bj, which 
is used as an "iteration counter" to determine 
whether the program Is completed. 

1^4. These 2 lines constitute the standard calling se- 
quence for submission of I/O requests to the 
Executive System. 

15, Register B*+ is used as an iteration counter to de- 
termine the end of the minor loop, I.e., whether 
X has reached 999. 
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16. XREG (see comment #2) is used as an Index Register 
to modify TOUT, so that successive results will be 
stored in successive locations of the TOUT table. 
The 16 least significant positions of XREG are 
also stored in XLOC, which becomes the address of 
the current value of X. 

17. The actual evaluation of x 3 + ax 2 is performed. 

18. The macro-instruction is executed with the para- 
meters representing the addresses of the current 
values of x and b. 

19. The result of each iteration is stored in some 
location within the table TOUT, as determined by 
the value of XREG. XREG is incremented, as spe- 
cified by the asterisk. 

20. A test is made to determine whether the value of 
x has reached 999 • If no, the contents of the 
iteration counter B*+ are decreased by 1 , and 
another iteration is made. If it has, the main 
loop is finished, and the 1000 results are to be 
written on tape. 

21 . The Read Drum instruction is modified so that the 
next set of values for a, b, and c will be read. 

22. This is the standard ending instruction to ter- 
minate the program and relinquish control to the 
Executive System. 

23. The following instructions are placed in the data 
bank. See comment #12. 

2h. PKT1 consists of H- lines of coding which constitute 
the Read Drum I/O Execution Packet. 

25". REQ1 is a Request Parameter for the above. 

26. INDXWD is the initial setting of XREG. 

27. REQ2 is a Request Parameter for the Write Tape I/O 
request . 

28. PKT2 consists of h lines of coding which constitute 
the Write Tape I/O Execution Packet. 

29. ERDPRO defines the end of the program and identifies 
START as the address of the first instruction to be 
executed . 
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SAMPLE PROGRAM FLOW CHART 





INITIALIZE 



READ 
AjBjCj 



EVALUATE 

FOR 
Xj(Aj Bj Cj) 



^ X = 999? \ 



YES 



NO 




STEP UP X 
BY 1 





WRITE 1000 
RESULTS 



FINISHED? ) ( END 



f FINISHED? \ 



NO 




RESET INDEX 

REGISTER 

FOR X TO 99 



STEP UP 




FIGURE 37 
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EXE : POLYNOMIAL EVALUATION 
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I/O DEFINITIONS 
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,S |P|A|C, E 


1 : 








DATA TABLE DEFINITIONS 




I |T|A|B,C| 


D|T,A|B|L| E 


, L A B C = 3 : 


9 


l i T i°i U i T i 


D i TA i B i L i E 


,LOUT = igr0f0 . 


10 




S ,P, A,C, E 


1 : 




I |M|A,C,A, 


,M i A | C, R, 


o 


11 




i i L i D i P i 


$A11 ,(1) : 






i i s i u i b i 


$A 1 1 f 5,,$UOP : 






i |L|D|P, 


$A12 # (1) J 






1 l M ! P S l 


$A12 / (1) : 




1 1 1 1 1 1 


1 l A l D ! D l 


$A12,(2) : 






1 l D l V lh 


$A12,$A11 : 






E|N|D,M|A|C 








iE| J | E, C t T 








1 |B,A,N| K 




12 


iSUiAiRiTi 


l 1L1D1B1 


$B5.199„$UOP : 


13 




i |L|D|P| 


SQgr^EQl : 


14 




i l i M i J i p i 


$Bl # $XIO : 


14 




i i L i D i B i 


$B4,999 f/ $UOP : 


15 




1 l L ! D l B l 


XREG.INDXWD : 


16 




1 i S i T i B i 


XREG,XLOC lf $H2 






,S,P, A, C, E 
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1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 37 COMMENTS 


NOTES 


. . E . V , A , L , 




. L D P , 

1 L L_1__L_ 

1 |M|P|S, 




$A5,XLOC : 


17 




$A5,$A5 






1 1 1 1 I 


$A5,XLOC : 






| l L l D l P l 


$A6,XLOC 






, |M,P,$, 


$A6 f $A6 : 






» t 


$A6,ABC : 






,M | A,C | A | 


(XLOC) (ABC + 1) : 


18 




I |M|P|S, 


$A12, ABC + 1 






1 l A i D l D i 


$A5 r $A6 : 






I l A l D i D i 


$A5 # $A12 x 






i i S UB i 


$A5,ABC + 2 : 






I i S i T i P i 


$A5, TOUT, XREG* : 


19 




,r ,X, J J P , 


$B4,EVAL-2 : 


20 




I i l i d I P i 


$A7 # PKT1 + 1 s 






i i A i D i D i 


$A7 # 3 ff $UOP ' 


21 




I |S|T,P, 


$A7,PKT1 + 1 : 


21 


i w i r i' i T l E i 


_L_LtL?L?J_ 
,L|M JP, 


$Q0 # REQ2 ! 


14 




$Bl,$XIO : 


14 




,1 ,X, J,P, 


$B5 f START + l : 






LM J P, 


$B1,$END 


22 




S |P, A,C|E 


1 : 






|D|B| A,N|K 




23 


i |.X|L,0,C| 


i i i W, i 


' 




I iPiKiTili 


I 1 |W| i 


& ' 


24 




i l R i D i i 


ABC : 






I i i 1 i i 


LABCJABC : 






i i i W i l 


: 




I |R|E,Q, 1, 


1 I | H l i 


(T f PKTl ! 


25 


, f ,N ,D , X, W,D 


1 l i H i i 


1,0 : 


26 


i ,R i E, Q| 2, 


i i i H i i 


, P K T 2 


27 



FIGURE 38 (Cont) 



CO 

f 

a 



1 TAG 7 


8 


9 FUNCTION 14 


15 


SUB FIELDS 37 COMMENTS 


NOTES 


. . p . K . T i 2 . 




_._J_L_i__L_ 
|W,T,2 , 5, 


■ 


<* : 


28 


1 1 1 1 1 1 


TAPE! : 




1 1 1 1 1 1 


.,!»,, 


LOUT, TOUT : 




1 1 I 1 1 1 


_ i 1 1 W]_J— 

E,N | D, P,R ,0 


or : 




III!! 


START s 


29 


1 1 1 1 1 1 


I I I I i 






1 1 1 1 1 1 


_L i 1 L J_ 






1 1 1 1 1 1 


1 1 1 1 1 


* 
• 




1 1 1 1 1 1 


1 1 1 1 1 


: 




1 1 1 1 1 1 . 


1 1 1 1 1 


:: 




1 1 1 1 1 1 


1 I 1 1 1 


:: 




1 1 1 1 1 I 


1 1 1 1 1 


<► 




1 1 1 1 1 


: 




1 1 1 1 1 1 


1 1 1 1 1 


: 




1 1 1 1 1 I 


l 1 l 1 l 


: 




| 1 1 I I 








1... l._ 1_._1 i. _ 

i i ! : i 






















i i i i i 








i i i i i 








i 1 i i i 








i i i > i 






1 | 1 I 1 1 


i i i i I 








i I i i i 








i i i i i 








i i I i i 








i i 1 i i 








i i i i i 








1 1 l i 1 
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APPENDIX A 

FIELDATA CHARACTER SET 



OCTAL 






OCTAL 








CODE 


CHARACTER 


CODE 


CHARACTER 


00 


Mastei 


1 Space 


ko 


) 






1 


Upper 


Case 


1 


- 






2 


Lower 


Case 


2 


+ 






3 


Tab 




3 


< 


or 


i 


h 


Carr is 


\ge Return 


*f 


— 


or 


# 


5 


Space 


or A 


5 


> 


or 


& 


6 


A 




6 








7 


B 




7 


$ 






10 


C 




50 


* 






1 


D 




1 


( 






2 


E 




2 


M 






3 


F 




3 


; 






if 


G 




k 


7 






5 


H 




5 


j 






6 


I 




6 


5 






7 


J 




7 


STOP 


® 


20 


K 




60 









1 


L 




1 


1 






2 


M 




2 


2 






3 


N 




3 


3 






k 







i+ 


^ 






5 


P 




5 


5 






6 


Q 




6 


6 






7 


R 




7 


7 






30 


S 




70 


8 






1 


T 




1 


9 






2 


U 




2 


i 






3 


V 




3 


• 






h 


W 




k 


/ 






5 


X 




5 


• 






6 


Y 




6 


Sp 


ecial 


7 


Z 




7 


Backspace 



SLEUTH 70 



APPENDIX B 



INSTRUCTION REPERTOIRE 













EXECUTION 














TIME 




f 


J 


NAME 


DESCRIPTION 




IN 1. 


' SEC. 


MNEMONIC 




Alternate 


Same 


CODE 












Core 


Core 














Banks 


Bank 




01 


0-17 


Store Positive 


(A)-> U 




4.0 


8.0 


STP 


02 






Store Negative 


- (A) -> U 




4.0 


8.0 


STN 


03 






Store Magnitude 


l(A)l-> U 




4.0 


8.0 


STM 


04 






Store R a 


(Ra) -> U 




4.0 


8.0 


STR 


05 






Store Zero 


0-» U (Clear U) 




4.0 


8.0 


STZ 


06 






Store B a 


(B a ) -» U 




4.0 


8.0 


STB 


10 






Load Positive 


(U)-» A 




4.0 


8.0 


LDP 


11 






Load Negative 


-(U)->A 




4.0 


8.0 


LDN 


12 






Load Positive Magnitude 


KU)l-> A 




4.0 


8.0 


LDM 


13 






Load Negative Magnitude 


-l(U)l^ A 




4.0 


8.0 


LNM 


14 






Add 


(A) + (U) -> A 




4.0 


8.0 


ADD 


15 






Subtract 


(A)-(U)-»A 




4.0 


8.0 


SUB 


16 






Add Magnitude 


(A) + I(U)I-*A 




4.0 


8.0 


ADM 


17 






Subtract Magnitude 


(A)-l(U)|-> A 




4.0 


8.0 


SBM 


20 






Add and Load 


(A) + (U) -> A + 1 




4.0 


8.0 


ADL 


21 






Subtract and Load 


(A) - (U) -> A + 1 




4.0 


8.0 


SBL 


22f 






Block Transfer 


(W)i -> (V)i repeated k times. 




8.0 


8.0 


BTR 










Initial Vi address is u + (B b ) 17-0, and subse- 
















quent addresses are formed by incrementa- 
















tion by (B b )3 5 .-i 8 . Similarly, y 2 addresses £ 


rs 
















u + (B a )i7-o incremented by (B a ) 35 ._i8. 










23 






Load R a 


(U)-» R a 




4.0 


8.0 


LDR 


24 






Add to B a 


(B a ) + (U) -> B a 




4.0 


8.0 


ADB 


25 






Subtract from B a 


(B a ) - (U) -> B a 




4.0 


8.0 


SBB 


26 






Load B a Modifier Only 


(U) -* B„7-o 




4.0 


8.0 


LBM 


27 






Load B a 


(U) -> B a 




4.0 


8.0 


LDB 


30 






Multiply Integer 


(A)« (U)-> A,A+ 1 




12.0 


16.0 


MPI 


31 






Multiply Single (Integer) 


(A)-(U)-* A 




12.0 


16.0 


MPS 


32 






Multiply Fractional 


(A) • (U) -* A, A + 1 




12.0 


16.0 


MPF 


34 






Divide (Integer) 


(A, A + 1) -r- (U); Quotient-* A 

Porvkom^/x^ _ v A 1 1 

RCntdifiuci - y r-i -j- x 




31.3 


35.3 


DVI 


35 






Divide Single and Load (Fractional) 


(A) -f-(U); Quotient^ A + l 
No Remainder 




31.3 


35.3 


DVL 


36 






Divide (Fractional) 


(A, A + 1) -7- (U); Quotient-* A 

Remainder -» A + l 




31.3 


35.3 


DVF 


40 






Selective Set 


(A) -> A -j- 1. Then set (A + l) n for (U)„ = 
i.e., (A) © (U)-*A+1 


=1 


4.0 


8.0 


SSE 


41 






Selective Complement 


(A) -» A + 1. Then complement (A + l) n 

for(U) n = l 

i.e., (A) © (U) -> A -f 1 




4.0 


8.0 


SCP 


42 






Selective Clear 


(A) -» A + 1. Then clear (A -f l) n for 

(U)„ = 1 

i.e., (A) (U) -»• A + 1 




4.0 


8.0 


SCL 


43 






Selective Substitute 


(A) -* A + 1. Then (U)„ -* (A + 1)„ for 

(M)„ = 1 

i.e., (A) © (M)' + (U) © (M) -* A + 1 




4.7 


8.7 


SSU 


44 






Selective Even Parity Test 


If [(A) (U)] is even parity, Skip Nl 


No Skip 
Skip 


6.0 
10.0 


10.0 
14.0 


SEP 


45 






Selective Odd Parity Test 


If [(A) (U)] is odd parity, Skip Nl 


No Skip 
Skip 


6.0 
10.0 


10.0 
14.0 


SOP 


47 






Test Modifier 


If (B a ), 7 -o < (U), take Nl; If (B a ), 7 :.o > (U) 
Skip. In either case, 

(B a )i7--0 + (B a )35 -18 ~> B a i7-o 


t 

No Skip 

Skip 


4.7 
8.7 


8.7 
12.7 


TMO 


50 






Test Zero 


SkipNI if (U) = 0. 


No Skip 
Skip 


4.0 
8.0 


8.0 
12.0 


TZR 


51 






Test Not Zero 


SkipNI if (U)^0 


No Skip 
Skip 


4.0 
8.0 


8.0 
12.0 


TNZ 


52 






Test Equal 


Skip Nl if (U) = (A) 


No Skip 
Skip 


4.0 
8.0 


8.0 
12.0 


TEQ 


53 






Test Not Equal 


Skip Nl if (U) ^ (A) 


No Skip 
Skip 


4.0 
8.0 


8.0 
12.0 


TNE 


54 






Test Less Than or Equal 


Skip Nl if (U) £ (A) 


No Skip 
Skip 


4.0 
8.0 


8.0 
12.0 


TLE 


55 






Test Greater Than 


Skip Nl if (U) > (A) 


No Skip 
Skip 


4.0 
8.0 


8.0 
12.0 


TGR 


56 






Test Within Limits 


Skip Nl if (A) < (U) < (A + 1) 


No Skip 


4.7 


8.7 


TWL 




\ 


' 




(Note: (A) < (A + 1)) 


Skip 


8.7 


12.7 




57 




Test Outside Limits 


Skip Nl if (U) < (A) or (U) >(A + 1) 


No Skip 


4.7 


8.7 


TOL 










(Note: (A^ < (A + 1)) 


Skip 


8.7 


12.7 





t Repeat operations 62-67, 71 take 16 n sec comb 
takes 12 p. sec combined setup and termination 



ned setup and termination time. The block transfer (22) 
time.' 



SLEUTH 71 



INSTRUCTION REPERTOIRE 











EXECUTION 












TIME 




f 


J 


NAME 


DESCRIPTION 


IN n 


SEC. 


MNEMONIC 




Alternate 


Same 


CODE 










Core 


Core 












Banks 


Bank 




60 


0-17 


Test Positive 


Skip Nl if (U) > NO Skip 


4.0 


8.0 


TPO 










Skip 


8.0 


12.0 




61 






Test Negative 


Skip Nl if (U) < No Skip 

Skip 


4.0 
8.0 


8.0 
12.0 


TNG 


62t 






Search Equal 


Skip Nl if (U); = (A) No Skip 
Repeated k times Skip 


4.0 
4.0 


4.0 
4.0 


SEQ 


63t 






Search Not Equal 


Skip Nl if (U)i ^ (A) No Skip 
Repeated k times Skip 


4.0 
4.0 


4.0 
4.0 


SNE 


64t 






Search Less Than or Equal 


Skip Nl if (U)j < (A) No Skip 
Repeated k times Skip 


4.0 
4.0 


4.0 
4.0 


SLE 


65t 






Search Greater Than 


Skip Nl if (U)i > (A) No Skip 

Skip 


4.0 
4.0 


4.0 
4.0 


SGR 


66t 






Search Within Limits 


SkipNI if (A)< (U)j^(A+ 1) No Skip 
(Note: (A)< (A + 1)) Skip 


4.7 
4.7 


4.7 
4.7 


SWL 


67t 






Search Outside Limits 


Skip Nl if (U)i < (A) or (U)i > (A+l) No Skip 


4.7 


4.7 


SOL 




1 


f 




(Note: (A) < (A + 1)) Skip 


4.7 


4.7 




70 




Index Jump 


If (CM) ia > 0, Jump to U No Jump 


8.0 


8.0 


IXJP 








(CM)ja < 0, Take Nl Jump 


4.0 


4.0 










Then (CMTfra — 1 -» CM ja 














NOTE: j in this instruction serves with the 














a-designator to specify any one of the 128 








71t 


* 




words of Control Memory. 








00 


Masked Search Equal 


Skip Nl if (U)i0 (M) = (A)Q (M) No Skip 


4.0 


4.0 


MSEQ 








Repeated k times Skip 


4.0 


4.0 






01 


Masked Search Not Equal 


Skip Nl if (U)i © (M) ^ (A) Q (M) No Skip 
Repeated k times Skip 


4.0 
4.0 


4.0 
4.0 


MSNE 




02 


Masked Search Less Than 


Skip Nl if (U), (M) < (A) Q (M) No Skip 


4.0 


4.0 


MSLE 






or Equal 


Repeated k times Skip 


4.0 


4.0 






03 


Masked Search Greater Than 


Skip Nl if (U)i © (M) > (A) Q (M) No Skip 
Repeated k times Skip 


4.0 
4.0 


4.0 
4.0 


MSGR 




04 


Masked Search Within Limits 


SkipNI if (A) O (M) <(U)iQ(M) 

< (A + 1) O (M) No Skip 

— (Note: (A) Q (M) < Skip 

(A + 1) O (M)) 
Repeated k times 


4.7 
4.7 


4.7 
4.7 


MSWL 




05 


Masked Search Outside Limits 


Skip Nl if (U), O (M) < (A) or 

(U) © (M)< (A + 1) — No Skip 

(Note: (A) © (M) < Skip 

(A + 1) O (M)) 
Repeated k times 


4.7 
4.7 


4.7 
4.7 


MSOL 


72 


00 


Wait for Interrupt 


The computer program sequence stops 
(i.e., P is not advanced). The wait condi- 
tion is removed by an interrupt. 


4.0 




WAIT 




01 


Return Jump 


(P) -* U17..0 and Jump to U + 1 


8.0 


8.0 


RTJP 




02 


Positive Bit Control Jump 


If (A) 3 5 = 0, Jump to U No Jump 
Shift (A) left one in either case Jump 


4.0 
8.0 


4.0 
8.0 


PBJP 




03 


Negative Bit Control Jump 


If (A>35 = 1, Jump to U No Jump 
Shift (A) left one in either case Jump 


4.0 
8.0 


4.0 
8.0 


NBJP 




04 


Add Halves 


(A)i7~o + (U) )7 ~o-> Al7-0 

(A) 3 5--18 + (U)35 -18 -> A35--I8 


4.0 


8.0 


ADDH 




05 


Subtract Halves 


(A), 7-0 — (U),7~0 -> A 17 ~o 
(A) 3 5-18 — (U)35--18 -» A35--I8 


4.0 


8.0 


SUBH 




06 


Add Thirds 


(A) 3 5 -24 + (U) 3 5--24 -> A35-24 
(A)23--12 + (U)23--12- > A23--12 

(A)n-o + (U)n-o-» An-o 


4.0 


8.0 


ADDT 




07 


Subtract Thirds 


(A) 3 5-24 — (U) 3 5 -24 ~> A35..24 
(A)23--12 — (U)23--12 -» A23-12 

(A)n-o— (U)ii-o-* A n ..o 


4.0 


8.0 


SUBT 




10 


Execute Remote Instruction 


Execute the Instruction at U 


4.0 


+ Executi 


EXRI 

on Time 




11 


Load Memory Lockout Register 


U5-0 -> MLR 

For U = 1 lockout 0-4095 
U, = 1 lockout 4096-8191 
U 2 = 1 lockout 8192-16383 
U 3 = 1 lockout 16384-32767 
U 4 = 1 lockout applies to 1st BANK 


4.0 




LMLR 


732 






U 5 =-l lockout applies to 2nd BANK 








00 


Single Right Circular Shift!: 


Shift (A) right U places circularly 


4.0 




SCSH 




01 


Double Right Circular Shift 


Shift (A, A + 1) right U places circularly 


4.0 




DCSH 




02 


Single Right Logical Shift 


Shift (A) right U places, end off; fill with 


4.0 




SLSH 










zeros (Max. Shift — 36) 









*j serves as part of the Function Code 

t Repeat operations 62-67, 71 take 16 n sec combined setup and termination time. The block transfer (22) 

takes 12 n sec combined setup and termination time. 
^Instruction execution time is independent of the number of shifts performed (e.g. a shift of 72 takes 4 microseconds). There 

are no memory references in the first six shift instructions, 73 00 — 73 05; consequently, the distinction between alternate core 

banks and the same core bank is irrelevant. 

SLEUTH 72 



INSTRUCTION xREPERIOIRE 



74 



75 



76 



04 
05 

06 



00 

01 

02 

03 

04 
05 

06 

07 

10 

11 

12 



13 
14 
15 
16 
17 



00 

01 

02 
03 
04 

05 

06 
07 
10 

11 

12 
13 

14 
15 

16 

17 

* 

00 
01 
02 
03 

04 

05 

06 



NAME 



Single Right Arithmetic Shift 
Double Right Arithmetic Shift 

Scale Factor Shift 



Zero Jump 

Non-zero Jump 

Positive Jump 

Negative Jump 

Console Selective Jump 
Selective Stop Jump 

No Operation 

Enable All External Interrupts 
and Jump 
Even Jump 

Odd Jump 

Modifier Jump 



Load Modifier and Jump 
Overflow Jump 
No-Overflow Jump 
Carry Jump 
No-Carry Jump 



Initiate Input Mode 

Initiate Monitored Input Mode 

Input Mode Jump 
Terminate Input Mode 
Initiate Output Mode 

Initiate Monitored Output Mode 

Output Mode Jump 
Terminate Output Mode 
Initiate Function Mode 

Initiate Monitored Function Mode 

Function Mode Jump 
Force External Transfer 

Enable All External Interrupts 
Disable All External Interrupts 

Enable Single External Interrupt 

Disable Single External Interrupt 

Floating Add 
Floating Subtract 
Floating Multiply 
Floating Divide 

Floating Point Unpack 

Floating Point Normalize Pack 

Floating Characteristic 
Difference Magnitude 



Floating Characteristic 
Difference 



07 
*j serves as part of the Function Code 



DESCRIPTION 



C !-.;«• fh A 



1 \ r\rtU* I I r>lo/~oc 



fill with zeros. (Max. Shift = 72) 
Shift (A) right U places, end off; fill with sign bits. 
Shift (A, A + 1) right U places, end off; 

fill with sign bits. (Max. Shift = 72) 
(U) -> A, shift A left circularly until A 35 ^ A 34 

or until A has been shifted 36 times. Store 

the scaled quantity in A and the number of 

shifts that occurred in A + 1. 



Jump to U if (A) = 
Jump to U if (A) ^ 
Jump to U if (A) > 
Jump to U if (A) < 



No Jump 
Jump 
No Jump 
Jump 
No Jump 
Jump 
No Jump 
Jump 

Jump to U if A = key setting on console (1 of 15) 
Stop if A = stop key setting on console (1 of 4), 

always jump to U 
Do Nothing; continue with Ni 

Jump to U and permit interrupts to occur 



Jump to U if (A) 
Jump to U if (A) 



No Jump 
Jump 
No Jump 
Jump 

If (B a )i7~o > 0, Jump to U No Jump 

If (B a )i7~o < 0, Take NI Jump 

In either case (B a ) 17 „ + (B a ) 3 5--i8-» B a i 7 .. 
(P) -» (B a )i7 -o and Jump to U 
Jump to U if overflow cond. is set 
Jump to U if overflow cond. is not set 
Jump to U if carry cond. is set 
Jump to U if carry cond. is not set 



(U) -> input control word a, and initiate 

input mode on channel a. 
(U) -> input control word a, and initiate 

input mode on channel a with monitor. 
Jump to U if channel a is in the input mode. 
Terminate input mode on channel a. 
(U) -> output control word a, and initiate 

output mode on channel a. 
(U) -> output control word a, and initiate 

output mode on channel a with monitor. 
Jump to U if channel a is in the output mode. 
Terminate output mode on channel a. 
(U) -» output control word a, and initiate 

function mode on channel a. 
(U) -» output control word a, and initiate 

function mode on channel a with monitor. 
Jump to U if channel a is in the function mode. 
Request external function or output word 

on channel a. 
All external interrupts are permitted to occur. 
All external interrupts are prevented 

from occurring. 
An external interrupt on channel a 

is permitted to occur. 
An external interrupt on channel a 

is prevented from occurring. 

(A) + (U) -» A, A + 1 
(A)-(U)-» A, A + 1 
(A) • (U)->A,A+1 
(A) 4- (U); Quotient-* A 

Remainder -> A -f 1 
Unpack (U), store mantissa in A -f 1 and store 

the biased characteristic in A 
Normalize (A) pack with biased characteristic 

from (U) and store at A + 1 

Absolute value of |(A) 34 -27J — I (U) 34 ~27| -» A + 1 

|(A)34~27|-|(U)34~27|-* A+l 
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EXECUTION 

TIME 

IN n SEC. 



Alternate 
Core 
Banks 



4.0 
4.0 

6.0 



Same 
Core 
Bank 



10.0 



4.0 


4.0 


ZRJP 


8.0 


8.0 




4.0 


4.0 


NZJP 


8.0 


8.0 




4.0 


4.0 


POJP 


8.0 


8.0 




4.0 


4.0 


NGJP 


8.0 


8.0 




4.0 


4.0 


CSJP 


4.0 


4.0 


SSJP 


4.0 


4.0 


NOOP 


4.0 


4.0 


EIJP 


4.0 


4.0 


EVJP 


8.0 


8.0 




4.0 


4.0 


ODJP 


8.0 


8.0 




4.0 


4.0 


MOJP 


8.0 


8.0 




4.0 


4.0 


LMJP 


4.0 


4.0 


OVJP 


4.0 


4.0 


NOJP 


4.0 


4.0 


CYJP 


4.0 


4.0 


NCJP 


4.0 


8.0 


IIPM 


4.0 


8.0 


IMIM 


4.0 


4.0 


IMJP 


4.0 


4.0 


TIPM 


4.0 


8.0 


I0PM 


4.0 


8.0 


IMOM 


4.0 


4.0 


OMJP 


4.0 


4.0 


TOPM 


4.0 


8.0 


IFNM 


4.0 


8.0 


IMFM 


4.0 


4.0 


FMJP 


4.0 


4.0 


FEXT 


4.0 


4.0 


EAEI 


4.0 


4.0 


DAEI 


4.0 


4.0 


ESEI 


4.0 


4.0 


DSEI 


14.0 


18.0 


FLAD 


14.0 


18.0 


FLSB 


13.3 


17.3 


FLMP 


26.7 


30.7 


FLDV 


4.0 


8.0 


FLUP 


7.3 


11.3 


FLNP 


4.0 


8.0 


FLCM 


4.0 


8.0 


FLCD 



MNEMONIC 
CODE 



SASH 
DASH 

SFSH 



APPENDIX C 

ASSEMBLER-DEFINED (SOFTWARE) FUNCTIONS 

1 • Generatives 



I/O Function word 




t 


F 


f, 


f f 

2 ' 3 


I/O Access-cont 


;rol 


word 


t 


A 


f > 


f 2> f 3 


Whole Word 






t 


W 


fi 


Floating point 


word 


t 


WF 


f 13 


f 2 


Fixed point scaled 


word 


t 


WX 


fi, 


f 5 f c 


Half-word 






t 


H 


f 15 


r»2 3 
? 


Third -word 






t 


T 


fi, 


f f 

2 ' 3 


Sixth-word 






t 


S 


fi> 


I 2 J 1q? 1/iS I F=l 5 1 fi 


Variable Field 
Character Code 






t 
t 


G 
SC 


y_\, yv r -v b n 

11 3 -Lis x S 5 • • • i n 


Block Reservation 




t 


RESV 


n 





2. Declaratives 

Program start 
Program end 
Equality 

Instruction Bank Definiti 
Data Bank definition 
Data Table definition 
Start Macro definition 
End Macro definition 
Jump Swith Definition 

I/O channel def Inition-dr 

-ta 
-pa 
-Pr 
-Ca 
I/O Unit definition input- 

-non-inp 
-paper tape 
-paper tape 
-High-Speed 
-Card Reader 
-Card Punch 
-Card Read-P 



on 



t 
t 

t 

urn 

pe 

per ta 

Inter 

rd 

tape 

ut tap 

reader 

punch 

Printe 



unch 



PRO 

END PRO 
EQU 

IBANK 

DBANK 

DTABLE 

MACRO 

ENDMAC 

SWITCH 

t 
t 
t 
t 
t 
t 
t 
t 
t 
t 
t 
t 
t 



pe 



f 

= n. 



Drum Table definition 

Space (program listing) 

EJECT (program listing) 

Start Correction routine 

End Correction routine 

Delete Instructions-* 

-single line 
-many lines 

Insert new Instructions 



MDCH 

MTCH 

PTCH 

HPCH 

CDCH 

INT 

MTT 

PTR 

PTP 

HSP 

CR 

CP 

CRP 

MDT 
SPACE 
EJECT 

COR 
ENDCOR 
DELETE 
DELETE 
DELETE 
FOLLOW 



2 3 

2 ? 

2 f 



=n 
=n 
=n 
=n 
=n 
=n 
=n 
=n 
=n 
=n 
=n 
=n 
=n 

=n, 
n 



f . 



13 - 2 
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APPENDIX D: 



EXTERNAL INPUT/OUTPUT 



FUNCTION REPERTOIRE 



rnuQiiiea oy pre- 
fixing the letter I. This will change the code to the corre- 
sponding function followed by an external interrupt. Execu- 
tive I/O functions are never prefixed. 



In the fourth column below H and E 
executive respectively. 



stand for hardware and 



Tape 



(Octal Code) (Mnemonic) 



(Function Name) 



(Use) 



Drum 



01 
02 
20 
21 
^0 
*f1 


WT12 

WT25 

REW 

REWL 

BOOT 

RTFL 


h2 


RTFN 


>+3 


RTFH 


61 


RTBL 


62 


RTBN 


63 


RTBH 


h5 


STFL 


he 


STFN 


h? 


STFH 


65 


STBL 


66 


STBN 


67 


STBH 


^3 


RTFS 


63 


RTBS 


H.1 

61 


MTF 
MTB 


02 

\2 


WD 
RD 


h5 

he 


SD 
SRD 




SLEUTH 75 



Write Tape at 12.5 KC 


HE 


Write tape at 25 KC 


HE 


Rewind 


HE 


Rewind with interlock 


HE 


Bootstrap 


HE 


Read tape forward low 


H 


gain 




Read tape forward 


HE 


normal gain 




Read tape forward 


H 


high gain 




Read tape backward low 


H 


gain 




Read tape backward 


HE 


normal gain 




Read tape backward 


H 


high gain 




Search tape forward 


H 


low gain 




Search tape forward 


TTT71 

mi 


normal gain 




Search tape forward 


T-T 

J.1 


high gain 




Search tape backward 


H 


low gain 




Search tape backward 


HE 


normal gain 




Search tape backward 


H 


high gain 




Read tape forward with 


E 


sentinel check 




Read tape backward with 


E 


sentinel check 




Move tape forward 


E 


Move tape backward 


E 



Write drum 
Read drum 
Search drum 
Search Read Drum 



HE 
HE 
HE 
HE 





52 


BRD 


Block read 


. drum 


E 




55 


BSD 


Block Search drum 


E 




56 


BSRD 


Block sear 


■ch read drum 


E 




62 


CBRD 


Chain Block read drum 


E 


Card 














62 


CFDI 


Condition 
put 


Fieldata in- 


HE 




63 


CCBI 


Condition 
input 


column binary 


HE 




6^ 


CRBI 


Condition 
input 


row binary 


HE 




0»+ 


CFDO 


Condition 
Output 


Fieldata 


HE 




05 


CCBO 


Condition 
Output 


column binary 


HE 




06 


CRBO 


Condition 
Output 


row binary 


HE 




>+3 


TC 


Trip card 




HE 




in 


RC 


Read card 




HE 




h2 


RCTF 


Read card 


trip fill 


HE 




hh 


RCTS 


Read card 


trip fill 


E 








sentinel check 






02 


PCS0 


Punch card stacker 


E 




03 


PCS1 


Punch card stacker 1 


E 




60 


SS1 


Select Stacker 1 


H 




61 


SS2 


Select Stacker 2 


H 


Printer 














02 


PHSP 


Print high speed 


HE 








printer 






Control 














22 


CCH 


Clear channel 


H 




23 


TERM 


Terminate 


channel 


HE 




2*f 


RCH 


Request channel 


H 




26 


DCH 


Demand channel 


H 




07 


RLI 


Remove log 


*ical inter- 


E 



17 
33 



lock 

IRLI Input only-remove E 

interlock 
ITERM Input only-terminate E 

requests 
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APPEM3IX E 

ASSEMBLER -DEFINED SYMBOLS 
1 . a-type Designators 



to $B15 B-Registers 

$A0 to $A"\5 A-Reglsters 

$Q0 to $Q3 Q-Registers 

$R0 to $R15 Special Registers 

2. j-type Designators 

$W Whole word generative 

$H1-$H2 Half-word generative 

$XH1 -$XH2 Ha If -word generative with sign extension 

$T1 -$T3 Third -word generative 

$>S1 -$S6 Sixth-word generative 

$U0P u -fie Id is actual operand 

$XU0P Same, with sign extension 

3. Miscellaneous Symbols 

$L Current instruction address 

SPARAM Special Data Table for EXEC ROC 

$ERR0R Special Data Table for EXEC ROC 
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APPENDIX F 

MODIFIABLE FIELDS 

Field Bits Coding Restricted To 

25-22 Channel Tag Direct I/O 

29-00 I/O Unit Tag Executive I/O 

Drum Address + Constant Executive I/O 

Drum Address + Drum Length Tag Executive I/O 

22-00 Drum Address + Constant Direct I/O 

Drum Address + Drum Length Tag Direct I/O 

Drum Length + Constant 

1 6 
33-^8 Drum Length + Constant Length < 2 

33-18 I/O Unit Tag 

or I/O Access Word Tag Direct I/O 

1 5-00 System Tag 

Label + Constant 

Data Table Tag + Constant 

Length Tag + Constant 

Data Table Tag + Length Tag 

L + Constant 
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INDEX 



A 

A, 52 

A-type Designator, \5 

ABS, 27 

Absolute Operand, 19 

Absolute Tag, 12 

Accidental duplication, h5 

Actual value, 9 

AOC , 1 , 51 

Asterisk: instruction deletion, 9 

b-field incrementation, 21 
h-field incrementation, 21 



B-field, 21 

B-field incrementation, 21 



Block reservation, 25 



C 



Character code generation, 25 

Character, FIELDATA, 9 

Character, special, 9 

Comments, 7 

COR, h2 

Corrections, h-2 

CSJP, 17, 35 

Current Location Counter ($L), 13 



D 



D, 53 

Data Table Length Tag, 13, 32 
Data Table Tag, 13, 31 
DBANK, 29 

Declarative instructions, 27 
DELETE, h2 

Designator: a-type, 15 
j-type, 16 
DIR, 27 
DIRECT ROC, 1 
Ditto mark, 1 1 

Drum Table Length Tag, 1^,33 
Drum Table Tag, 1^,33 
DTABLE, 31 
Duplication, accidental, h5 
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E 



EJECT, 35 
ENDCOR, If 3 
ENDMAC, 36 
ENDPRO, 27 
ENTRY, 62 
EQU, 28 
Equality, 28 
ERROR, 58 
EXE, 27 
EXEC ROC, 2 

F 

f 5^ 

FIELDATA codes, 9,25 

Fixed point scaled numbers, 8,23 

Floating point numbers, 8,23 

FOLLOW, If 3 

Function code, 10, 17 

Function field, 6 



G 



H 



G,2*+ 

Generative instructions, 22 



H,23 

H-field incrementation, 21 

Half-word generation, 23 



I, 53 

I/O Access Word Tag, 15,52 

I/O Channel Tag, 1*f, 51 

I/O External Function words, 53 

I/O Unit Tag, 15,51 

IBANK, 29 

Incrementation: b-field, 21 

h-field, 21 

Label, 13 

Table Length Tag, 22 
Index Registers, 21 
Indirect Addressing, 21 
Input/Output , ^0 
Integer, decimal and octal, 6 



J 



J-field, 21 



J-type Designator, 16 
JUMP, 17,35 
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L 



Label, 12 



Library sub-routines, 60 
Line of coding, 9 
Listing, 3^,^' 
Literal expression, 29 



MACRO, 36 

Macro-instructions, 36 
Memory lockout, 20 
Modifiable fields, ^8 



NI, 53 
ND, 53 

lNitsXo -lijls oT uc uj-uFi, \y 

Numbers, 6 

Numerical word generation, 22 



Omitting fields, 6 
Operand, 18 



PARAM, 58 

Partial word generation, 23 

PRO, 27 

Program specification, 27 



Relocation, hQ 
RESV, 25 
ROC-DIRECT, 1 
ROC -EXEC, 2 



M 



N 



R 



S 



S, 23 

Sample program, 63 

SC, 25 

SEC, h5 

Segmenting, 29,^9 

Segment Length Tag, 1^+ 

Selective Jump Switch, 35 

Shift Count, 20 

Sign-coded or uncoded, 8 

Sixth-words, 23 

Skeleton, macro-instruction 37 
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SPACE, 35 

Special Character, 9 

Special Data Tables, 58 

Special Registers, 17 

Sub-fields, 6 

SWITCH, 35 

Symbol, 8 

System Tag, 1*+ 



T, 23 

Table definition, 31 
Tag definition, 11 , 17 
Tag field, 6 
Third-words, 23 



V 



Variable Bit Generation, 24 






U 


U-field, 18 






W 


W, 22 
WF, 23 

wx, 23 

Whole Words, 22 





X 

XREF, 61 
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UIMIVAC 



DIVISION OF SPEBRV RAND CORPORATION 
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